Compartilhar via


Add-Computer

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

Sintaxe

Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-UnjoinDomainCredential <PSCredential>]
   -Credential <PSCredential>
   [-DomainName] <String>
   [-OUPath <String>]
   [-Server <String>]
   [-Unsecure]
   [-Options <JoinOptions>]
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-Credential <PSCredential>]
   [-WorkgroupName] <String>
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Add-Computer adiciona o computador local ou computadores remotos a um domínio ou grupo de trabalho ou os move 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 UO (unidade organizacional) e um controlador de domínio ou para executar uma junção não seguras.

Para obter os resultados do comando, use os parâmetros detalhados e PassThru.

Exemplos

Exemplo 1: Adicionar um computador local a um domínio e, em seguida, reiniciar o computador

Add-Computer -DomainName Domain01 -Restart

Esse comando adiciona o computador local ao domínio Domain01 e reinicia o computador para tornar a alteração eficaz.

Exemplo 2: Adicionar um computador local a um grupo de trabalho

Add-Computer -WorkgroupName WORKGROUP-A

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

Exemplo 3: Adicionar um computador local a um domínio

Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose

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: adicionar um computador local a um domínio usando o parâmetro OUPath

Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"

Esse comando adiciona o computador local ao domínio Domain02. Ele usa o parâmetro OUPath para especificar a unidade organizacional para as novas contas.

Exemplo 5: adicionar um computador local a um domínio usando credenciais

Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -Force

Esse comando adiciona o computador Server01 ao domínio Domain02. Ele usa o parâmetro LocalCredential para especificar uma conta de usuário que tenha permissão para se conectar ao computador Server01. Ele usa o parâmetro Credential para especificar uma conta de usuário que tenha permissão para ingressar computadores no domínio. Ele usa o parâmetro Reiniciar para reiniciar o computador após a conclusão da operação de junção e o parâmetro Force para suprimir as mensagens de confirmação do usuário.

Exemplo 6: mover um grupo de computadores para um novo domínio

Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -Restart

Esse comando move os computadores Server01 e Server02 e o computador local, de Domain01 para Domain02.

Ele usa o parâmetro LocalCredential para especificar uma conta de usuário que tenha permissão para se conectar aos três computadores afetados. Ele usa o parâmetro UnjoinDomainCredential para especificar uma conta de usuário que tenha permissão para desacompar os computadores do domínio Domain01 e o parâmetro Credential para especificar uma conta de usuário que tenha permissão para ingressar os computadores no domínio Domain02. Ele usa o parâmetro Reiniciar para reiniciar os três computadores após a conclusão da movimentação.

Exemplo 7: mover um computador para um novo domínio e alterar o nome do computador

Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -Restart

Esse comando move o computador Server01 para o Domain02 e altera o nome do computador para Server044.

O comando usa a credencial do usuário atual para se conectar ao computador Server01 e desacompossá-lo de seu domínio atual. Ele usa o parâmetro Credential para especificar uma conta de usuário que tenha permissão para ingressar o computador no domínio Domain02.

Exemplo 8: Adicionar computadores listados em um arquivo a um novo domínio

Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade  -Restart

Esse comando adiciona os computadores listados no arquivo Servers.txt ao domínio Domain02. Ele usa o parâmetro opções de para especificar a opção Win9xUpgrade. O parâmetro Restart reinicia todos os computadores recém-adicionados após a conclusão da operação de junção.

Parâmetros

-ComputerName

Especifica os computadores a serem adicionados a um domínio ou grupo de trabalho. O padrão é o computador local.

Digite o nome NetBIOS, um endereço IP (Internet Protocol) ou um nome de domínio totalmente qualificado de cada um 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 Windows PowerShell. Você pode usar o parâmetro ComputerName de Add-Computer mesmo se o computador não estiver configurado para executar comandos remotos.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Tipo:String[]
Cargo:Named
Valor padrão:Local computer
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

Especifica uma conta de usuário que tem permissão para ingressar os computadores em um novo domínio. O padrão é o usuário atual.

Digite um nome de usuário, como "User01" ou "Domain01\User01", ou insira um objeto PSCredential, como um gerado pelo cmdlet Get-Credential. Se você digitar um nome de usuário, será solicitado que você solicite 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. Para especificar uma conta de usuário que tenha permissão para se conectar a um computador remoto, use o parâmetro LocalCredential.

Tipo:PSCredential
Aliases:DomainCredential
Cargo:Named
Valor padrão:Current User Account Credentials
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DomainName

Especifica o domínio ao qual os computadores são adicionados. Esse parâmetro é necessário ao adicionar os computadores a um domínio.

Tipo:String
Aliases:DN, Domain
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Suprime o prompt de confirmação do usuário. Sem esse parâmetro, Add-Computer requer que você confirme a adição de cada computador.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LocalCredential

Especifica uma conta de usuário que tem permissão para se conectar aos computadores especificados pelo parâmetro ComputerName. O padrão é o usuário atual.

Digite um nome de usuário, como "User01" ou "Domain01\User01", ou insira um objeto PSCredential, como um gerado pelo cmdlet Get-Credential. Se você digitar um nome de usuário, será solicitado que você solicite uma senha.

Para especificar uma conta de usuário que tenha permissão para adicionar os computadores a um novo domínio, use o parâmetro credencial. Para especificar uma conta de usuário que tenha permissão para remover os computadores de seu domínio atual, use o parâmetro UnjoinDomainCredential.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Tipo:PSCredential
Cargo:Named
Valor padrão:Current user
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NewName

Especifica um novo nome para o computador no novo domínio. Esse parâmetro é válido somente quando um computador está sendo adicionado ou movido.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Options

Especifica opções avançadas para a operação de junção do Add-Computer. Insira um ou mais valores em uma cadeia de caracteres separada por vírgulas.

Os valores aceitáveis para este parâmetro são:

  • AccountCreate: cria uma conta de domínio. O cmdlet Add-Computer cria automaticamente uma conta de domínio quando adiciona um computador a um domínio. Essa opção está incluída para fins de integridade.

  • Win9XUpgrade: indica que a operação de junção faz parte de uma atualização do sistema operacional Windows.

  • unsecuredJoin: executa uma junção não assegurada. Para solicitar uma junção não seguras, use o parâmetro Não Seguro ou essa opção.

  • PasswordPass: define a senha do computador para o valor do parâmetro de Credencial (DomainCredential) após a execução de uma junção não simultânea. Essa opção também indica que o valor do parâmetro Credential (DomainCredential) é uma senha de computador, não uma senha de usuário. Essa opção é válida somente quando a opção UnsecuredJoin é especificada.

JoinWithNewName: renomeia o nome do computador no novo domínio para o nome especificado pelo parâmetro NewName. Quando você usa o parâmetro NewName, essa opção é definida automaticamente. Essa opção foi projetada para ser usada com o cmdlet Rename-Computer. Se você usar o cmdlet Rename-Computer para renomear o computador, mas não reiniciar o computador para tornar a alteração eficaz, você poderá usar esse parâmetro para ingressar o computador em um domínio com seu novo nome.

  • JoinReadOnly: usa uma conta de computador existente para ingressar o computador em um controlador de domínio somente leitura. A conta do computador deve ser adicionada à lista de permissões para a política de replicação de senha e a senha da conta deve ser replicada para o controlador de domínio somente leitura antes da operação de junção.

  • InstallInvoke: define os sinalizadores create (0x2) e delete (0x4) do parâmetro FJoinOptions do método JoinDomainOrWorkgroup. Para obter mais informações sobre o método JoinDomainOrWorkgroup , consulte método JoinDomainOrWorkgroup da classe Win32_ComputerSystem na biblioteca MSDN. Para obter mais informações sobre essas opções, consulte função NetJoinDomain na biblioteca MSDN.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Tipo:JoinOptions
Valores aceitos:AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OUPath

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

Tipo:String
Aliases:OU
Cargo:Named
Valor padrão:The default OU for machine objects for in the domain
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Restart

Reinicia os computadores que foram adicionados ao domínio ou grupo de trabalho. Uma reinicialização geralmente é necessária para tornar a alteração eficaz.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Server

Especifica o nome de um controlador de domínio que adiciona o computador ao domínio. Insira o nome no formato DomainName\ComputerName. Por padrão, nenhum controlador de domínio é especificado.

Tipo:String
Aliases:DC
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UnjoinDomainCredential

Especifica uma conta de usuário que tem permissão para remover os computadores de seus domínios atuais. O padrão é o usuário atual.

Digite um nome de usuário, como "User01" ou "Domain01\User01", ou insira um objeto PSCredential, como um gerado pelo cmdlet Get-Credential. Se você digitar um nome de usuário, será solicitado que você solicite uma senha.

Use esse parâmetro ao mover computadores para um domínio diferente. Para especificar uma conta de usuário que tenha permissão para ingressar no novo domínio, use o parâmetro Credential. Para especificar uma conta de usuário que tenha permissão para se conectar a um computador remoto, use o parâmetro LocalCredential.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Unsecure

Executa uma junção não seguras ao domínio especificado.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WorkgroupName

Especifica o nome de um grupo de trabalho ao qual os computadores são adicionados. O valor padrão é "WORKGROUP".

Tipo:String
Aliases:WGN
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode redirecionar nomes de computador e novos nomes para o cmdlet Add-Computer.

Saídas

ComputerChangeInfo

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

Observações

  • No Windows PowerShell 2.0, o parâmetro Server de Add-Computer falha mesmo quando o servidor está presente. No Windows PowerShell 3.0, a implementação do parâmetro Server é alterada para que ele funcione de forma confiável.