Add-Computer

Sintaxe

Domain (Predefinição)

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

Workgroup

Add-Computer
    [-WorkgroupName] <String>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

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

Add-Computer -DomainName Domain01 -Restart

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

Add-Computer -WorkgroupName WORKGROUP-A

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

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

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"

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

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

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

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

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 que o computador não esteja configurado para executar comandos remotos.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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 escrever um nome de utilizador, ser-lhe-á solicitada uma palavra-passe.

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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-DomainName

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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 escrever um nome de utilizador, ser-lhe-á solicitada uma palavra-passe.

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.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Options

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

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

• ContaCriar: 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. Esta opção está incluída para ser completa.

• Win9XUpgrade: Indica que a operação de junçã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.

• PasswordPass: Define a senha da máquina para 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. Esta 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 efetiva, poderá usar esse parâmetro para associar o computador a um domínio com seu novo nome.

• JoinReadOnly : usa uma conta de máquina existente para unir o computador a um controlador de domínio somente leitura. A conta da máquina deve ser adicionada à lista permitida 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 associaçã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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-OUPath

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Restart

Reinicia os computadores que foram adicionados ao domínio ou grupo de trabalho. Muitas vezes, é necessário reiniciar para tornar a alteração efetiva.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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 escrever um nome de utilizador, ser-lhe-á solicitada uma palavra-passe.

Use esse parâmetro quando 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.

Esse parâmetro é introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Unsecure

Executa uma associação não segura ao domínio especificado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-WorkgroupName

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

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

String

Saídas

ComputerChangeInfo

Notas

Ligações Relacionadas

• Checkpoint-Computer
• Remover Computador
• Reiniciar-Computador
• Rename-Computer
• Restore-Computer
• Parar Computador
• Test-Connection