Compartilhar via

Remove-Computer

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

Remove o computador local do seu domínio.

Syntax

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 Remove-Computer cmdlet 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 descompar 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, quando um computador é removido de um domínio, você deverá movê-lo para um grupo de trabalho. Utilize 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 Add-Computer cmdlet .

Para obter os resultados do comando, utilize os parâmetros Verbose e PassThru. Para suprimir o prompt do usuário, utilize 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 ao sair 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 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. Os parâmetros comuns PassThru e Verbose exibem informações sobre o êxito ou a 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 chamado 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 OldServers.txt arquivo de seus domínios e os move para o grupo de trabalho Herdado .

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 Restart 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.

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

-Confirm

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

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

-Force

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

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

-LocalCredential

Especifica uma conta de usuário que tem permissão para se conectar aos computadores especificados pelo parâmetro ComputerName . 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 Get-Credential 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 do seu domínio atual, utilize o parâmetro UnjoinDomainCredential.

Esse parâmetro foi introduzido no PowerShell 3.0.

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

-PassThru

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

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

-Restart

Indica que esse cmdlet reinicia os computadores que estão sendo removidos. Uma reinicialização é geralmente necessária para que as alterações entrem em vigor.

Esse parâmetro foi introduzido no PowerShell 3.0.

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

-UnjoinDomainCredential

Especifica uma conta de usuário que tenha 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 a computadores remotos, use o parâmetro LocalCredential.

Esse parâmetro foi introduzido no PowerShell 3.0.

Type:PSCredential
Aliases:Credential
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

-WorkgroupName

Especifica o nome de um grupo de trabalho ao qual os computadores são adicionados ao serem removidos de seus domínios. O valor padrão é WORKGROUP. Quando um computador é removido de um domínio, é necessário adicioná-lo a um grupo de trabalho.

Esse parâmetro foi introduzido no PowerShell 3.0.

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

Entradas

String

Você pode canalizar nomes de computador para estecmdlet.

Saídas

ComputerChangeInfo

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

Observações

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