Aggiunge il computer locale a un dominio o a un gruppo di lavoro.
Sintassi
Add-Computer [-DomainName] <string> [-Credential <PSCredential>] [-OUPath <string>] [-Server <string>] [-Unsecure] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Add-Computer [-WorkGroupName] <string> [-Credential <PSCredential>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Add-Computer aggiunge il computer locale a un dominio o a un gruppo di lavoro o lo sposta da un dominio a un altro. Se il computer viene aggiunto al dominio senza un account, crea inoltre un account di dominio.
È possibile utilizzare i parametri di questo cmdlet per specificare un'unità organizzativa e un controller di dominio oppure per eseguire un'aggiunta non sicura.
Per ottenere i risultati del comando, utilizzare i parametri Verbose e PassThru.
Parametri
-Credential <PSCredential>
Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente.
Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01", o immettere un oggetto PSCredential, ad esempio uno generato dal cmdlet Get-Credential. Se si digita un nome utente, viene richiesta una password.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
Current User Account Credentials |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-DomainName <string>
Specifica un dominio per l'account del computer. Questo parametro è obbligatorio.
|
Obbligatorio? |
true |
|
Posizione? |
2 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-OUPath <string>
Specifica l'unità organizzativa per l'account di dominio. Immettere il nome completo dell'unità organizzativa. Il valore predefinito è l'unità organizzativa predefinita per gli oggetti computer nel dominio.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
The default OU for machine objects for in the domain |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-PassThru
Restituisce i risultati del comando. Per impostazione predefinita, il cmdlet non genera alcun output.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Server <string>
Specifica il nome di un controller di dominio che aggiunge il computer al dominio. Immettere il nome nel formato DomainName\ComputerName. Il valore predefinito è il computer locale.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Unsecure
Esegue un'aggiunta non protetta.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WorkGroupName <string>
Specifica il nome del gruppo di lavoro per il computer. Se si omette questo parametro, il computer viene aggiunto a un dominio.
|
Obbligatorio? |
true |
|
Posizione? |
3 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
Nessuno Non è possibile reindirizzare oggetti a Add-Computer. |
|
Output |
Microsoft.PowerShell.Commands.ComputerChangeInfo Quando si utilizza il parametro PassThru, Add-Computer restituisce un oggetto ComputerChangeInfo. Negli altri casi, il cmdlet non genera alcun output. |
Esempio 1
C:\PS>add-computer -domainname Domain01; restart-computer Descrizione ----------- Con questi comandi il computer locale viene aggiunto al dominio Domain01 utilizzando le credenziali dell'utente corrente. Con il primo comando il computer viene aggiunto al dominio. Nel secondo comando viene utilizzato il cmdlet Restart-Computer per riavviare il computer, completando così l'operazione di aggiunta. Il punto e virgola (;) separa i due comandi.
Esempio 2
C:\PS>add-computer -workgroupname WORKGROUP-A Descrizione ----------- Con questo comando il computer locale viene aggiunto al gruppo di lavoro Workgroup-A.
Esempio 3
C:\PS>add-computer -DomainName Domain01 -Server Domain01\DC01 -passthru -verbose Descrizione ----------- Con questo comando il computer locale viene aggiunto al dominio Domain01 utilizzando il controller di dominio Domain01\DC01. Nel comando vengono utilizzati i parametri PassThru e Verbose per ottenere informazioni dettagliate sui risultati del comando.
Esempio 4
C:\PS>Add-Computer -domainname Domain02 -OUPath OU=testOU,DC=domain,DC=Domain,DC=com Descrizione ----------- Con questo comando vengono aggiunti i computer Server01 e Server02 al domino Domain02. Viene utilizzato il comando OUPath per specificare l'unità organizzativa per i nuovi account.
Esempio 5
C:\PS>Add-Computer -domainname Domain02 -cred Domain02\Admin02 -passthru Descrizione ----------- Con questo comando il computer locale viene aggiunto al dominio Domain02 tramite le credenziali di un amministratore di dominio. Nel comando viene utilizzato il parametro PassThru per generare un breve report dei risultati del comando.
Vedere anche