wdsutil add device

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 e Windows Server 2012

Prepara previamente um computador no AD DS (Active Directory Domain Services). Computadores preparados previamente também são chamados de computadores conhecidos. Isso permite que você configure propriedades para controlar a instalação do cliente. Por exemplo, é possível configurar um programa de inicialização de rede e o arquivo autônomo que o cliente deve receber, além do servidor do qual o cliente deve baixar o programa de inicialização da rede.

Sintaxe

wdsutil /add-Device /Device:<Devicename> /ID:<UUID | MAC address> [/ReferralServer:<Servername>] [/BootProgram:<Relativepath>] [/WdsClientUnattend:<Relativepath>] [/User:<Domain\User | User@Domain>] [/JoinRights:{JoinOnly | Full}] [/JoinDomain:{Yes | No}] [/BootImagepath:<Relativepath>] [/OU:<DN of OU>] [/Domain:<Domain>]

Parâmetros

Parâmetro Descrição
/Device:<Devicename> Especifica o nome do dispositivo a ser adicionado.
/ID:<UUID|MAC address> Especifica o GUID/UUID ou o endereço MAC do computador. Um GUID/UUID deve estar em um dos dois formatos: cadeia de caracteres binária (/ID:ACEFA3E81F20694E953EB2DAA1E8B1B6) ou cadeia de caracteres GUID (/ID:E8A3EFAC-201F-4E69-953E-B2DAA1E8B1B6). Um endereço MAC deve estar no seguinte formato: 00B056882FDC (sem traços) ou 00-B0-56-88-2F-DC (com traços)
[/ReferralServer:<Servername>] Especifica o nome do servidor a ser contatado para baixar o programa de inicialização de rede e a imagem de inicialização usando o tftp.
[/BootProgram:<Relativepath>] Especifica o caminho relativo da pasta remoteInstall para o programa de inicialização de rede que este computador deve receber. Por exemplo: boot\x86\pxeboot.com
[/WdsClientUnattend:<Relativepath>] Especifica o caminho relativo da pasta remoteInstall para o arquivo de instalação autônoma que automatiza as telas de instalação do cliente dos Serviços de Implantação do Windows.
[/User:<Domain\User|User@Domain>] Define permissões no objeto de conta do computador para dar ao usuário especificado os direitos necessários para ingressar o computador no domínio.
[/JoinRights:{JoinOnly|Full}] Especifica o tipo de direitos a serem atribuídos ao usuário.
  • JoinOnly – Exige que o administrador redefina a conta do computador antes que o usuário possa ingressar o computador no domínio.
  • Full – Dá acesso completo ao usuário, o que inclui o direito de ingressar o computador no domínio.
[/JoinDomain:{Yes|No}] Especifica se o computador deve ser ingressado no domínio como esta conta de computador durante a instalação do sistema operacional. O valor padrão é Sim.
[/BootImagepath:<Relativepath>] Especifica o caminho relativo da pasta remoteInstall para a imagem de inicialização e este computador deve usar.
[/OU:<DN of OU>] O nome diferenciado da unidade organizacional em que o objeto da conta de computador deve ser criado. Por exemplo: OU=MyOU,CN=Test, DC=Domain,DC=com. O local padrão é o contêiner do computador padrão.
[/Domain:<Domain>] O domínio em que o objeto da conta de computador deve ser criado. O local padrão é o domínio local.

Exemplos

Para adicionar um computador usando um endereço MAC, digite:

wdsutil /add-Device /Device:computer1 /ID:00-B0-56-88-2F-DC

Para adicionar um computador usando uma cadeia de caracteres GUID, digite:

wdsutil /add-Device /Device:computer1 /ID:{E8A3EFAC-201F-4E69-953F-B2DAA1E8B1B6} /ReferralServer:WDSServer1 /BootProgram:boot\x86\pxeboot.com/WDSClientUnattend:WDSClientUnattend\unattend.xml /User:Domain\MyUser/JoinRights:Full /BootImagepath:boot\x86\images\boot.wim /OU:OU=MyOU,CN=Test,DC=Domain,DC=com