Remove-Computer
Remove o computador local de seu domínio.
Sintaxe
Local (Default)
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 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
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.
Este 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Remote
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Suprime o prompt do usuário. Por padrão, Remove-Computer solicita confirmação antes de remover cada computador.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 or 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 de seu domínio atual, use o parâmetro UnjoinDomainCredential.
Esse parâmetro foi introduzido no PowerShell 3.0.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Remote
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PassThru
Retorna os resultados do comando. Caso contrário, esse cmdlet não gerará nenhuma saída.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Credencial |
Conjuntos de parâmetros
Local
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Remote
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 parâmetro
Observações
Esse cmdlet não remove computadores de grupos de trabalho.