Remove-Computer
Rimuove il computer locale dal relativo dominio.
Sintassi
Local (Impostazione predefinita)
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remote
Remove-Computer
-UnjoinDomainCredential <PSCredential>
[-LocalCredential <PSCredential>]
[-Restart]
[-ComputerName <String[]>]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Remove-Computer rimuove il computer locale e i computer remoti dai domini correnti.
Quando si rimuove un computer da un dominio, Remove-Computer disabilita anche l'account di dominio del computer. È necessario fornire credenziali esplicite per annullare la connessione del computer dal dominio, anche quando sono le credenziali dell'utente corrente. È necessario riavviare il computer per rendere effettiva la modifica. Inoltre, quando si rimuove un computer da un dominio, è necessario spostarlo in un gruppo di lavoro. Usare il parametro WorkgroupName per specificare il gruppo di lavoro.
Per spostare un computer da un gruppo di lavoro a un dominio, da un gruppo di lavoro a un altro o da un dominio a un altro, usare il cmdlet Add-Computer.
Per ottenere i risultati del comando, usare i parametri Verbose e PassThru. Per eliminare il prompt dell'utente, usare il parametro Force.
Remove-Computer rimuove il computer locale e i computer remoti dai domini. Include parametri delle credenziali che specificano credenziali alternative per la connessione a computer remoti e la separazione da un dominio, un parametro Restart per riavviare i computer interessati e un parametro WorkgroupName per specificare il nome del gruppo di lavoro a cui vengono aggiunti i computer.
Esempio
Esempio 1: Rimuovere il computer locale dal relativo dominio
In questo esempio viene rimosso il computer locale dal dominio a cui viene aggiunto.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
Il parametro UnjoinDomainCredential fornisce le credenziali di un amministratore di dominio. Il PassThru e il verbose parametri comuni visualizzano informazioni sull'esito positivo o negativo del comando. Il parametro Restart riavvia il computer per completare l'operazione di rimozione.
Quando non viene specificato alcun nome del gruppo di lavoro, il computer viene spostato nel gruppo di lavoro denominato dopo che è stato rimosso dal relativo dominio.
Esempio 2: Spostare diversi computer in un gruppo di lavoro legacy
In questo esempio vengono rimossi tutti i computer elencati nel file di OldServers.txt dai domini e spostati nel gruppo di lavoro legacy legacy.
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart
Il parametro LocalCredential fornisce le credenziali di un utente autorizzato a connettersi ai computer remoti. Il parametro UnjoinDomainCredential fornisce le credenziali di un utente autorizzato a rimuovere i computer dai propri domini. Il parametro Force elimina le richieste di conferma per ogni computer. Il parametro Restart riavvia ogni computer dopo che è stato rimosso dal dominio.
Esempio 3: Rimuovere computer da un gruppo di lavoro senza conferma
Questo esempio rimuove il computer remoto, Server01 e il computer locale dai relativi domini e li aggiunge al gruppo di lavoro locale.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Il parametro Force elimina la richiesta di conferma per ogni computer. Il parametro Restart riavvia i computer per rendere effettiva la modifica.
Parametri
-ComputerName
Specifica i computer da rimuovere dai rispettivi domini. Il valore predefinito è il computer locale.
Digitare il nome NetBIOS, un indirizzo IP o un nome di dominio completo (FQDN) dei computer remoti. Per specificare il computer locale, digitare il nome del computer, un punto (.) o localhost.
Questo parametro non si basa sul remoting di PowerShell. È possibile utilizzare il parametro ComputerName di Remove-Computer anche se il computer non è configurato per eseguire comandi remoti.
Questo parametro è stato introdotto in PowerShell 3.0.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Remote
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Elimina la richiesta dell'utente. Per impostazione predefinita, Remove-Computer richiede conferma prima di rimuovere ogni computer.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LocalCredential
Specifica un account utente autorizzato a connettersi ai computer specificati dal parametro ComputerName. Il valore predefinito è l'utente corrente.
Digitare un nome utente, ad esempio
Questo parametro è stato introdotto in PowerShell 3.0.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Remote
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PassThru
Restituisce i risultati del comando. In caso contrario, questo cmdlet non genera alcun output.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Restart
Indica che questo cmdlet riavvia i computer da rimuovere. Un riavvio è spesso necessario per rendere effettiva la modifica.
Questo parametro è stato introdotto in PowerShell 3.0.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UnjoinDomainCredential
Specifica un account utente che dispone dell'autorizzazione per rimuovere i computer dai domini correnti. Le credenziali esplicite, fornite da questo parametro, sono necessarie per rimuovere i computer remoti da un dominio, anche quando il valore è le credenziali dell'utente corrente.
Digitare un nome utente, ad esempio User01 o Domain01\User01oppure immettere un oggetto PSCredential, ad esempio quello generato da Get-Credential. Se si digita un nome utente, questo cmdlet richiede una password.
Per specificare un account utente autorizzato a connettersi ai computer remoti, usare il parametro LocalCredential.
Questo parametro è stato introdotto in PowerShell 3.0.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Credenziali di accesso |
Set di parametri
Local
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
Remote
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WorkgroupName
Specifica il nome di un gruppo di lavoro a cui vengono aggiunti i computer quando vengono rimossi dai rispettivi domini. Il valore predefinito è WORKGROUP. Quando si rimuove un computer da un dominio, è necessario aggiungerlo a un gruppo di lavoro.
Questo parametro è stato introdotto in PowerShell 3.0.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
String
È possibile inviare tramite pipe i nomi dei computer a questo cmdlet.
Output
ComputerChangeInfo
Quando si utilizza il parametro PassThru, Remove-Computer restituisce un oggetto ComputerChangeInfo.
In caso contrario, questo cmdlet non genera alcun output.
Note
Questo cmdlet non rimuove i computer dai gruppi di lavoro.