Add-Computer
Adicione o computador local para um domínio ou grupo de trabalho.
Syntax
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 Add-Computer cmdlet 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 cria uma conta de domínio caso o computador seja adicionado ao domínio sem uma conta.
Você pode usar os parâmetros desse cmdlet para especificar uma unidade organizacional (UO) e um controlador de domínio ou para realizar uma junção não segura.
Para obter os resultados do comando, use os parâmetros Verbose e PassThru .
Exemplos
Exemplo 1: Adicionar um computador local a um domínio e reiniciar o computador
Add-Computer -DomainName Domain01 -RestartEste comando adiciona o computador local ao domínio Domain01 e, em seguida, reinicia o computador para que as alterações entrem em vigor.
Exemplo 2: Adicionar um computador local a um grupo de trabalho
Add-Computer -WorkgroupName WORKGROUP-AEste 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 -VerboseEste 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"Este comando adiciona o computador local ao domínio Domain02. Ele usa o parâmetro OUPath para especificar a unidade organizacional das 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 -ForceEste 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 Restart para reiniciar o computador após a conclusão da operação de associação e o parâmetro Force para suprimir 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 -RestartEste 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 cancelar a associação dos 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 Restart para reiniciar todos 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 -RestartEste comando move o computador Server01 para o Domain02 e altera o nome do computador para Server044.
O comando usa as credenciais do usuário atual para se conectar ao computador Server01 e removê-lo do 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 -RestartEsse comando adiciona os computadores listados no Servers.txt arquivo ao domínio Domain02. Ele usa o parâmetro Options 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.
Exemplo 9: Adicionar um computador a um domínio usando credenciais de computador predefinidas
Este primeiro comando deve ser executado por um administrador de um computador que já tenha ingressado no domínio Domain03:
New-ADComputer -Name "Server02" -AccountPassword (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
# Then this command is run from `Server02` which is not yet domain-joined:
$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
UserName = $null
Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
Add-Computer -Domain "Domain03" -Options UnsecuredJoin,PasswordPass -Credential $joinCredEssa combinação de comandos cria uma nova conta de computador com um nome predefinido e uma senha de ingresso temporário em um domínio usando um computador associado a um domínio existente. Em seguida, separadamente, um computador com o nome predefinido ingressa no domínio usando apenas o nome do computador e a senha de associação temporária. A senha predefinida é usada apenas para dar suporte à operação de associação e é substituída como parte dos procedimentos normais da conta do computador depois que o computador conclui a associaçã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 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.
Este parâmetro é introduzido no Windows PowerShell 3.0.
| Type: | String[] |
| Position: | Named |
| Default value: | Local computer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Especifica uma conta de usuário que tenha 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 Get-Credential cmdlet. Se você digitar um nome de usuário, uma senha será solicitada.
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 .
| Type: | PSCredential |
| Aliases: | DomainCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainName
Especifica o domínio ao qual os computadores são adicionados. Este parâmetro é necessário ao adicionar computadores a um domínio.
| Type: | String |
| Aliases: | DN, Domain |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Suprime o aviso de confirmação de usuário. Sem esse parâmetro, Add-Computer é necessário confirmar a adição de cada computador.
Este parâmetro é introduzido no Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Get-Credential cmdlet. Se você digitar um nome de usuário, uma senha será solicitada.
Para especificar uma conta de usuário que tenha permissão para adicionar os computadores a um novo domínio, use o parâmetro Credential . 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 .
Este parâmetro é introduzido no Windows PowerShell 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Especifica um novo nome para o computador no novo domínio. Este parâmetro é válido somente quando um computador está sendo adicionado ou movido.
Este parâmetro é introduzido no Windows PowerShell 3.0.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Options
Especifica opções avançadas para a Add-Computer operação de junção. Insira um ou mais valores em uma cadeia de caracteres separada por vírgulas.
Os valores aceitáveis para esse parâmetro são:
AccountCreate: cria uma conta de domínio. O
Add-Computercmdlet cria automaticamente uma conta de domínio quando adiciona um computador a um domínio. Esta opção está incluída para a completude.Win9XUpgrade: Indica que a operação de associação faz parte de uma atualização do sistema operacional Windows.
UnsecuredJoin: Executa uma associação não segura. Para solicitar uma associação não segura, use o parâmetro Unsecure ou esta opção. Se você quiser passar uma senha de máquina, então você deve usar esta opção em combinação com
PasswordPassopção.PasswordPass: define a senha do computador como o valor do parâmetro Credential(DomainCredential) depois de executar uma associação não segura. Essa opção também indica que o valor do parâmetro Credential (DomainCredential) é uma senha de máquina, não uma senha de usuário. Essa opção é válida somente quando a
UnsecuredJoinopção é especificada. Ao usar essa opção, a credencial fornecida ao-Credentialparâmetro deve ter um nome de usuário nulo.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
Rename-Computercmdlet para renomear o computador, mas não reiniciar o computador para tornar a alteração efetiva, poderá usar esse parâmetro para associar o computador a 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 de computador deve ser adicionada à lista de permitidos para a diretiva 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 ingresso.
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. Para obter mais informações sobre essas opções, consulte Função NetJoinDomain.
Este parâmetro foi introduzido no Windows PowerShell 3.0.
| Type: | JoinOptions |
| Accepted values: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OUPath
Especifica uma unidade organizacional (UO) para a conta de domínio. Digite o nome distinto completo da UO entre aspas. O valor padrão é o padrão da UO para objetos do computador no domínio.
| Type: | String |
| Aliases: | OU |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Restart
Reinicia os computadores que foram adicionados ao domínio ou grupo de trabalho. Uma reinicialização é geralmente necessária para que as alterações entrem em vigor.
Este parâmetro é introduzido no Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Server
Especifica o nome de um controlador de domínio que adiciona o computador ao domínio. Digite o nome no formato DomainName\ComputerName. Por padrão, nenhum controlador de domínio é especificado.
| Type: | String |
| Aliases: | DC |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnjoinDomainCredential
Especifica uma conta de usuário que tenha 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 Get-Credential cmdlet. Se você digitar um nome de usuário, uma senha será solicitada.
Use esse parâmetro quando você estiver movendo 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 .
Este parâmetro é introduzido no Windows PowerShell 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Unsecure
Executa um ingresso não seguro no domínio especificado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkgroupName
Especifica o nome de um grupo de trabalho para o qual os computadores são adicionados. O valor padrão é "WORKGROUP".
| Type: | String |
| Aliases: | WGN |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Você pode canalizar nomes de computador e novos nomes para o Add-Computer cmdlet.
Saídas
Quando você usa o parâmetro PassThru , Add-Computer retorna um objeto ComputerChangeInfo .
Caso contrário, este cmdlet não gera nenhuma saída.
Observações
- No Windows PowerShell 2.0, o parâmetro Server de
Add-Computerfalha 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.
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de