Partilhar 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 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 Add-Computer cmdlet.

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. Os parâmetros comuns PassThru e Verboseexibem 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 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 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. A predefiniçã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 mesmo Remove-Computer 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 a 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 prompt do 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 . A predefinição é o utilizador 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 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, esse cmdlet não gerará 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. Muitas vezes, é necessário reiniciar para tornar a alteração efetiva.

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

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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 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.

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

Notas

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