Compartilhar via

Remove-Computer

  • Referência
Módulo:
Microsoft.PowerShell.Management

Remove o computador local de seu domínio.

Sintaxe

Remove-Computer
      [[-UnjoinDomainCredential] <PSCredential>]
      [-Restart]
      [-Force]
      [-PassThru]
      [-WorkgroupName <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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 você remove um computador de um domínio, Remove-Computer também desabilita a conta de domínio do computador. Você deve fornecer credenciais explícitas para remover o computador de seu domínio, mesmo quando eles são as credenciais do usuário atual. Você deve reiniciar o computador para tornar a alteração eficaz. Além disso, ao remover 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 detalhados 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 credencial que especificam credenciais alternativas para se conectar a computadores remotos e descompar de um domínio, um parâmetro Reiniciar 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 de seu domínio

Este exemplo remove o computador local do domínio ao qual ele está ingressado.

Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart

O parâmetro UnjoinDomainCredential fornece as credenciais de um administrador de domínio. O PassThru e os parâmetros comuns detalhados exibem informações sobre o êxito ou falha do comando. O parâmetro Reiniciar 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 com o nome 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 herdado do.

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 de 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, o 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 de cada computador. O parâmetro Reiniciar reinicia os computadores para tornar a alteração eficaz.

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 FQDN (nome de domínio totalmente qualificado) 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 se o computador não estiver configurado para executar comandos remotos.

Esse parâmetro foi introduzido no PowerShell 3.0.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Suprime o prompt do usuário. Por padrão, Remove-Computer solicita confirmação antes de remover cada computador.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 gerado pelo cmdlet Get-Credential. 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 UnjoinDomainCredential.

Esse parâmetro foi introduzido no PowerShell 3.0.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Retorna os resultados do comando. Caso contrário, esse cmdlet não gerará nenhuma saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Restart

Indica que esse cmdlet reinicia os computadores que estão sendo removidos. Uma reinicialização geralmente é necessária para tornar a alteração eficaz.

Esse parâmetro foi introduzido no PowerShell 3.0.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 por 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.

Tipo:PSCredential
Aliases:Credential
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar nomes de computador para este cmdlet.

Saídas

ComputerChangeInfo

Quando você usa o parâmetro PassThru, Remove-Computer retorna um objeto ComputerChangeInfo. Caso contrário, esse cmdlet não gerará nenhuma saída.

Observações

Esse cmdlet não remove computadores de grupos de trabalho.