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
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
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
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
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.
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
Você pode redirecionar nomes de computador e novos nomes para o cmdlet Add-Computer
.
Saídas
Quando você usa o parâmetro
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.