Add-Computer

Artigo
10/30/2009

Adicione o computador local a um domínio ou grupo de trabalho.

Sintaxe

Add-Computer [-DomainName] <string> [-Credential <PSCredential>] [-OUPath <string>] [-Server <string>] [-Unsecure] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Add-Computer [-WorkGroupName] <string> [-Credential <PSCredential>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet Add-Computer adiciona o computador local a um domínio ou grupo de trabalho ou move-o de um domínio para outro. Ele também criará uma conta de domínio se o computador for adicionado ao domínio sem uma conta.

Você pode usar os parâmetros desse cmdlet para especificar uma OU (Unidade organizacional) e um controlador de domínio ou para executar um ingresso não seguro.

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.

Necessário?	false
Posição?	named
Valor padrão	Credenciais da conta de usuário atual
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-DomainName <string>

Especifica um domínio para a conta de computador. Esse parâmetro é obrigatório.

Necessário?	true
Posição?	2
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-OUPath <string>

Especifica uma OU (unidade organizacional) para a conta de domínio. Insira o nome totalmente diferenciado da OU. O valor padrão é a OU padrão para objetos de computador no domínio.

Necessário?	false
Posição?	named
Valor padrão	A OU padrão para objetos de computador no domínio
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-PassThru

Retorna os resultados do comando. Por padrão, este 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

-Server <string>

Especifica o nome de um controlador de domínio que adiciona o computador ao domínio. Insira o nome no formato Nome_do_domínio\Nome_do_computador. O padrão é o computador local.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Unsecure

Executa um ingresso sem segurança.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WorkGroupName <string>

Especifica o nome de um grupo de trabalho para o computador. Se este parâmetro for omitido, o computador ingressará em um domínio.

Necessário?	true
Posição?	3
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

Não é possível enviar objetos para Add-Computer.

Saídas

Microsoft.PowerShell.Commands.ComputerChangeInfo

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

Exemplo 1

C:\PS>add-computer -domainname Domain01; restart-computer

Descrição
-----------
Esses comandos adicionam o computador local ao domínio Domain01 que usa as credenciais do usuário atual.

O primeiro comando adiciona o computador ao domínio. O segundo comando usa o cmdlet Restart-Computer para reiniciar o computador, que conclui o una operação de ingresso. O ponto-e-vírgula (;) separa os dois comandos.

Exemplo 2

C:\PS>add-computer -workgroupname WORKGROUP-A

Descrição
-----------
Esse comando adiciona o computador local ao grupo de trabalho Workgroup-A.

Exemplo 3

C:\PS>add-computer -DomainName Domain01 -Server Domain01\DC01 -passthru -verbose

Descrição
-----------
Esse comando adiciona o computador local ao domínio Domain01 usando o controlador de domínio Domain01\DC01. 

O comando usa os parâmetros PassThru e Verbose para obter informações detalhadas sobre os resultados do comando.

Exemplo 4

C:\PS>Add-Computer -domainname Domain02 -OUPath OU=testOU,DC=domain,DC=Domain,DC=com

Descrição
-----------
Esse comando adiciona os computadores Server01 e Server02 ao domínio Domain02. Ele usa o comando OUPath para especificar a unidade organizacional das novas contas.

Exemplo 5

C:\PS>Add-Computer -domainname Domain02 -cred Domain02\Admin02 -passthru

Descrição
-----------
Esse comando adiciona o computador local ao domínio Domain02 usando as credenciais de um administrador de domínio. O comando usa o parâmetro PassThru para gerar um relatório resumido sobre os resultados do comando.

Consulte também

Conceitos

Checkpoint-Computer
Remove-Computer
Restart-Computer
Restore-Computer
Stop-Computer
Test-Connection

Share via