Condividi tramite


Add-Computer

Aggiungere il computer locale a un dominio o un gruppo di lavoro.

Sintassi

Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-UnjoinDomainCredential <PSCredential>]
   -Credential <PSCredential>
   [-DomainName] <String>
   [-OUPath <String>]
   [-Server <String>]
   [-Unsecure]
   [-Options <JoinOptions>]
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-Credential <PSCredential>]
   [-WorkgroupName] <String>
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il Add-Computer cmdlet aggiunge il computer locale o i computer remoti a un dominio o a un gruppo di lavoro oppure li sposta da un dominio a un altro. Viene inoltre creato un account di dominio se il computer viene aggiunto al dominio senza un account.

È possibile usare i parametri di questo cmdlet per specificare un'unità organizzativa e il controller di dominio o per eseguire un join non sicuro.

Per ottenere i risultati del comando, usare i parametri Verbose e PassThru.

Esempio

Esempio 1: Aggiungere un computer locale a un dominio e quindi riavviare il computer

Add-Computer -DomainName Domain01 -Restart

Questo comando aggiunge il computer locale al dominio Domain01 e riavvia il computer per rendere effettiva la modifica.

Esempio 2: Aggiungere un computer locale a un gruppo di lavoro

Add-Computer -WorkgroupName WORKGROUP-A

Questo comando aggiunge il computer locale al gruppo di lavoro Workgroup-A.

Esempio 3: Aggiungere un computer locale a un dominio

Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose

Questo comando aggiunge il computer locale al dominio Domain01 tramite il controller di dominio Domain01\DC01.

Il comando usa il parametri PassThru e Verbose per ottenere informazioni dettagliate sui risultati del comando.

Esempio 4: Aggiungere un computer locale a un dominio usando il parametro OUPath

Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"

Questo comando aggiunge il computer locale al dominio Domain02. Usa il parametro OUPath per specificare l'unità organizzativa per i nuovi account.

Esempio 5: Aggiungere un computer locale a un dominio usando le credenziali

Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -Force

Questo comando aggiunge il computer Server01 al dominio Domain02. Usa il parametro LocalCredential per specificare un account utente che dispone dell'autorizzazione per connettersi al computer Server01. Usa il parametro Credential per specificare un account utente che dispone dell'autorizzazione per aggiungere computer al dominio. Usa il parametro Restart per riavviare il computer dopo il completamento dell'operazione di join e il parametro Force per eliminare i messaggi di conferma dell'utente.

Esempio 6: Spostare un gruppo di computer in un nuovo dominio

Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -Restart

Questo comando sposta i computer Server01 e Server02 e il computer locale, da Domain01 a Domain02.

Usa il parametro LocalCredential per specificare un account utente che dispone dell'autorizzazione per connettersi ai tre computer interessati. Usa il parametro UnjoinDomainCredential per specificare un account utente che dispone dell'autorizzazione per separare il computer dal dominio Domain01 e il parametro Credential per specificare un account utente che dispone dell'autorizzazione per aggiungere computer al dominio Domain02. Usa il parametro Restart per riavviare tutti e tre i computer al termine dello spostamento.

Esempio 7: Spostare un computer in un nuovo dominio e modificare il nome del computer

Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -Restart

Questo comando sposta il computer Server01 nel dominio Domain02 e modifica il nome del computer in Server044.

Il comando usa le credenziali dell'utente corrente per connettersi al computer Server01 e separarsi dal dominio corrente. Usa il parametro Credential per specificare un account utente che dispone dell'autorizzazione per aggiungere il computer al dominio Domain02.

Esempio 8: Aggiungere computer elencati in un file a un nuovo dominio

Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade  -Restart

Questo comando aggiunge i computer elencati nel file Servers.txt al dominio Domain02. Usa il parametro Options per specificare l'opzione Win9xUpgrade. Il parametro Restart riavvia tutti i computer appena aggiunti al termine dell'operazione di join.

Parametri

-ComputerName

Specifica i computer da aggiungere a un dominio o un gruppo di lavoro. Il valore predefinito è il computer locale.

Digitare il nome NetBIOS, un indirizzo IP (Internet Protocol) o un nome di dominio completo di ognuno dei computer remoti. Per specificare il computer locale, digitare il nome del computer, un punto (.) o "localhost".

Questo parametro non si basa sulla comunicazione remota di Windows PowerShell. È possibile usare il parametro ComputerName di Add-Computer anche se il computer non è configurato per eseguire comandi remoti.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Type:String[]
Position:Named
Default value:Local computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifica un account utente che dispone dell'autorizzazione per aggiungere computer a un nuovo dominio. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio "User01" o "Domain01\User01" oppure immettere un oggetto PSCredential , ad esempio uno generato dal Get-Credential cmdlet. Se si digita un nome utente, viene richiesta una password.

Per specificare un account utente che dispone dell'autorizzazione per rimuovere il computer dal dominio corrente, usare il parametro UnjoinDomainCredential. Per specificare un account utente che dispone dell'autorizzazione per connettersi a un computer remoto, usare il parametro LocalCredential.

Type:PSCredential
Aliases:DomainCredential
Position:Named
Default value:Current User Account Credentials
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainName

Specifica il dominio a cui vengono aggiunti i computer. Questo parametro è obbligatorio quando si aggiunge il computer a un dominio.

Type:String
Aliases:DN, Domain
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Elimina la richiesta di conferma dell'utente. Senza questo parametro, Add-Computer è necessario confermare l'aggiunta di ogni computer.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalCredential

Specifica un account utente con l'autorizzazione per connettersi ai computer specificati dal parametro ComputerName. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio "User01" o "Domain01\User01" oppure immettere un oggetto PSCredential , ad esempio uno generato dal Get-Credential cmdlet. Se si digita un nome utente, viene richiesta una password.

Per specificare un account utente che dispone dell'autorizzazione per aggiungere computer a un nuovo dominio, usare il parametro Credential. Per specificare un account utente che dispone dell'autorizzazione per rimuovere computer dal dominio corrente, usare il parametro UnjoinDomainCredential.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Specifica un nuovo nome per il computer nel nuovo dominio. Questo parametro è valido solo quando un computer viene aggiunto o spostato.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Options

Specifica le opzioni avanzate per l'operazione di aggiunta al computer aggiuntivo. Immettere uno o più valori delimitati da virgole in una stringa.

I valori validi per questo parametro sono:

  • AccountCreate: crea un account di dominio. Il cmdlet Add-Computer crea automaticamente un account di dominio quando aggiunge un computer a un dominio. Questa opzione è inclusa per la completezza.

  • Win9XUpgrade: indica che l'operazione di join fa parte di un aggiornamento del sistema operativo Windows.

  • UnsecuredJoin: esegue un join non protetto. Per richiedere un join non protetto, usare il parametro Unsecure o questa opzione.

  • PasswordPass: imposta la password del computer sul valore del parametro Credential(DomainCredential) dopo aver eseguito un join non protetto. Questa opzione indica anche che il valore del parametro Credential (DomainCredential) è una password di computer, non una password utente. Questa opzione è valida solo quando è specificata l'opzione UnsecuredJoin.

-- JoinWithNewName: Rinomina il nome del computer nel nuovo dominio al nome specificato dal parametro NewName . Quando si usa il parametro NewName, questa opzione viene impostata automaticamente. Questa opzione è progettata per essere usata con il cmdlet Rename-Computer. Se si usa il cmdlet Rinomina-Computer per rinominare il computer, ma non riavviare il computer per rendere effettiva la modifica, è possibile usare questo parametro per aggiungere il computer a un dominio con il nuovo nome.

  • JoinReadOnly: usa un account computer esistente per aggiungere il computer a un controller di dominio di sola lettura. L'account del computer deve essere aggiunto all'elenco consentito per i criteri di replica delle password e la password dell'account deve essere replicata nel controller di dominio di sola lettura prima dell'operazione di join.

  • InstallInvoke: imposta i flag create (0x2) ed delete (0x4) del parametro FJoinOptions del metodo JoinDomainOrWorkgroup . Per altre informazioni sul metodo JoinDomainOrWorkgroup, vedere Metodo JoinDomainOrWorkgroup della classe Win32_ComputerSystem nella libreria MSDN. Per altre informazioni su queste opzioni, vedere Funzione NetJoinDomain nella libreria MSDN.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Type:JoinOptions
Accepted values:AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OUPath

Specifica un'unità organizzativa per l'account di dominio. Immettere il nome distinto completo dell'unità organizzativa racchiuso tra virgolette. Il valore predefinito è l'unità organizzativa predefinita per gli oggetti computer del dominio.

Type:String
Aliases:OU
Position:Named
Default value:The default OU for machine objects for in the domain
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Restart

Riavvia i computer aggiunti al dominio o al gruppo di lavoro. Spesso è necessario un riavvio per rendere effettiva la modifica.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Server

Specifica il nome di un controller di dominio che aggiunge il computer al dominio. Immettere il nome in formato NomeDominio\NomeComputer. Per impostazione predefinita, non viene specificato alcun controller di dominio.

Type:String
Aliases:DC
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UnjoinDomainCredential

Specifica un account utente che dispone dell'autorizzazione per rimuovere computer dal dominio corrente. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio "User01" o "Domain01\User01" oppure immettere un oggetto PSCredential , ad esempio uno generato dal Get-Credential cmdlet. Se si digita un nome utente, viene richiesta una password.

Usare questo parametro quando si spostano computer in un dominio diverso. Per specificare un account utente che dispone dell'autorizzazione per l'aggiunta al nuovo dominio, usare il parametro Credential. Per specificare un account utente che dispone dell'autorizzazione per connettersi a un computer remoto, usare il parametro LocalCredential.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Unsecure

Esegue un join non sicuro al dominio specificato.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkgroupName

Specifica il nome di un gruppo di lavoro a cui vengono aggiunti i computer. Il valore predefinito è "WORKGROUP".

Type:String
Aliases:WGN
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Input

String

È possibile inviare i nomi dei computer e i nuovi nomi al Add-Computer cmdlet.

Output

ComputerChangeInfo

Quando si usa il parametro PassThru , Add-Computerrestituisce un oggetto ComputerChangeInfo . In caso contrario, il cmdlet non genera alcun output.

Note

  • In Windows PowerShell 2.0 il parametro Server di Add-Computer ha esito negativo anche quando il server è presente. In Windows PowerShell 3.0 l'implementazione del parametro Server viene modificato affinché funzioni in modo affidabile.