Remove-Computer
Remove o computador local do seu domínio.
Sintaxe
Local (Predefinição)
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>]
Description
O cmdlet Remove-Computer remove o computador local e os computadores remotos de seus domínios atuais.
Quando remove um computador de um domínio, Remove-Computer também desativa a conta de domínio do computador. Você deve fornecer credenciais explícitas para desassociar o computador de seu domínio, mesmo quando elas são as credenciais do usuário atual. Tem de reiniciar o computador para tornar a alteração eficaz. Além disso, quando você remove um computador de um domínio, você deve movê-lo para um grupo de trabalho. Use o parâmetro WorkgroupName para especificar o grupo de trabalho.
Para mover um computador de um grupo de trabalho para um domínio, de um grupo de trabalho para outro ou de um domínio para outro, use o cmdlet Add-Computer.
Para obter os resultados do comando, use os parâmetros Verbose e PassThru. Para suprimir o prompt do usuário, use o parâmetro Force.
Remove-Computer remove o computador local e os computadores remotos dos domínios. Ele inclui parâmetros de credenciais que especificam credenciais alternativas para se conectar a computadores remotos e desingressar de um domínio, um parâmetro Restart para reiniciar os computadores afetados e um parâmetro WorkgroupName para especificar o nome do grupo de trabalho ao qual os computadores são adicionados.
Exemplos
Exemplo 1: Remover o computador local do seu domínio
Este exemplo remove o computador local do domínio ao qual ele está associado.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
O parâmetro UnjoinDomainCredential fornece as credenciais de um administrador de domínio. O PassThru e o Verbose parâmetros comuns exibem informações sobre o sucesso ou falha do comando. O parâmetro Restart reinicia o computador para concluir a operação de remoção.
Quando nenhum nome de grupo de trabalho é especificado, o computador é movido para o grupo de trabalho nomeado depois de ser removido de seu domínio.
Exemplo 2: Mover vários computadores para um grupo de trabalho herdado
Este exemplo remove todos os computadores listados no arquivo OldServers.txt de seus domínios e os move para o grupo de trabalho Legacy.
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart
O parâmetro LocalCredential fornece as credenciais de um usuário que tem permissão para se conectar a computadores remotos. O parâmetro UnjoinDomainCredential fornece as credenciais de um usuário que tem permissão para remover os computadores de seus domínios. O parâmetro Force suprime os prompts de confirmação para cada computador. O parâmetro Restart reinicia cada um dos computadores depois que ele é removido de seu domínio.
Exemplo 3: Remover computadores de um grupo de trabalho sem confirmação
Este exemplo remove o computador remoto, Server01 e o computador local de seus domínios e os adiciona ao grupo de trabalho Local.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
O parâmetro Force suprime o prompt de confirmação para cada computador. O parâmetro Restart reinicia os computadores para tornar a alteração efetiva.
Parâmetros
-ComputerName
Especifica os computadores a serem removidos de seus domínios. O padrão é o computador local.
Digite o nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado (FQDN) dos computadores remotos. Para especificar o computador local, digite o nome do computador, um ponto (.) ou localhost.
Esse parâmetro não depende da comunicação remota do PowerShell. Você pode usar o parâmetro ComputerName de Remove-Computer mesmo que o computador não esteja configurado para executar comandos remotos.
Esse parâmetro foi introduzido no PowerShell 3.0.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Remote
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Suprime o prompt do usuário. Por padrão, Remove-Computer solicita confirmação antes de remover cada computador.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-LocalCredential
Especifica uma conta de usuário que tem permissão para se conectar aos computadores que o parâmetro ComputerName especifica. O padrão é o usuário atual.
Digite um nome de usuário, como User01 ou Domain01\User01, ou insira um objeto PSCredential , como um Get-Credential gerado pelo cmdlet. Se você digitar um nome de usuário, o cmdlet solicitará uma senha. Para especificar uma conta de usuário que tenha permissão para remover o computador de seu domínio atual, use o parâmetro
Esse parâmetro foi introduzido no PowerShell 3.0.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Remote
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PassThru
Retorna os resultados do comando. Caso contrário, esse cmdlet não gerará nenhuma saída.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Restart
Indica que esse cmdlet reinicia os computadores que estão sendo removidos. Muitas vezes, é necessário reiniciar para tornar a alteração efetiva.
Esse parâmetro foi introduzido no PowerShell 3.0.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-UnjoinDomainCredential
Especifica uma conta de usuário que tem permissão para remover os computadores de seus domínios atuais. Credenciais explícitas, conforme fornecido por esse parâmetro, são necessárias para remover computadores remotos de um domínio, mesmo quando o valor é as credenciais do usuário atual.
Digite um nome de usuário, como User01 ou Domain01\User01, ou insira um objeto PSCredential , como um gerado pelo Get-Credential. Se você digitar um nome de usuário, esse cmdlet solicitará uma senha.
Para especificar uma conta de usuário que tenha permissão para se conectar aos computadores remotos, use o parâmetro LocalCredential.
Esse parâmetro foi introduzido no PowerShell 3.0.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Credencial |
Conjuntos de parâmetros
Local
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
Remote
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WorkgroupName
Especifica o nome de um grupo de trabalho ao qual os computadores são adicionados quando são removidos de seus domínios. O valor padrão é WORKGROUP. Ao remover um computador de um domínio, você deve adicioná-lo a um grupo de trabalho.
Esse parâmetro foi introduzido no PowerShell 3.0.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
String
Você pode canalizar nomes de computador para estecmdlet.
Saídas
ComputerChangeInfo
Quando você usa o PassThru parâmetro, Remove-Computer retorna um ComputerChangeInfo objeto.
Caso contrário, esse cmdlet não gerará nenhuma saída.
Notas
Este cmdlet não remove computadores de grupos de trabalho.