Remove-Computer
Remova o computador local de um domínio ou grupo de trabalho.
Sintaxe
Remove-Computer [[-Credential] <PSCredential>] [-Force] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrição
O cmdlet Remove-Computer remove o computador local de seu domínio ou grupo de trabalho atual.
Quando você remove um computador de um domínio, Remove-Computer também desabilita a conta de domínio do computador.
Quando o computador está em um domínio, você deve fornecer credenciais, mesmo quando elas são as credenciais do usuário atual. Você deve também reiniciar o computador para efetivar a alteração.
Para obter os resultados do comando, use os parâmetros Verbose e PassThru.
Parâmetros
-Credential <PSCredential>
Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual.
Digite um nome de usuário, como "User01" ou "Domain01\User01", ou insira um objeto PSCredential, como aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.
Para remover um computador de um domínio, você deve usar o parâmetro Credential, mesmo quando estiver usando as credenciais do usuário atual.
Necessário? |
false |
Posição? |
2 |
Valor padrão |
As credenciais do usuário atual |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Force
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-PassThru
Retorna os resultados do comando. Caso contrário, esse cmdlet não gera nenhuma saída.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Confirm
Solicita confirmação antes da execução do comando.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
Nenhum Você não pode canalizar a entrada para este cmdlet. |
Saídas |
Microsoft.PowerShell.Commands.ComputerChangeInfo Quando você usa o parâmetro PassThru, Remove-Computer retorna um objeto ComputerChangeInfo. Caso contrário, esse cmdlet não gera nenhuma saída. |
Exemplo 1
C:\PS>remove-computer
Descrição
-----------
Esse comando remove o computador de um grupo de trabalho.
Exemplo 2
C:\PS>remove-computer -credential domain01\admin01 -passthru -verbose; restart-computer
Descrição
-----------
Esses comandos removem o computador local do domínio ao qual é integrado.
O primeiro comando remove o computador do domínio. O comando usa o parâmetro Credential para fornecer as credenciais de um administrador de domínio. Ele usa o parâmetro PassThru e o parâmetro comum Verbose para exibir informações sobre o êxito ou a falha do comando.
O segundo comando usa o cmdlet Restart-Computer para reiniciar o computador, que é exigido para concluir o una operação de remoção.
O ponto-e-vírgula (;) separa os dois comandos.
Consulte também
Conceitos
Add-Computer
Checkpoint-Computer
Remove-Computer
Restart-Computer
Restore-Computer
Stop-Computer
Test-Connection