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 |
Current User Account Credentials |
|
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 |
The default OU for machine objects for in the domain |
|
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 |
None 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.
See Also