wdsutil set device

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

Altera os atributos de um computador preparado previamente. Um computador preparado previamente é um computador que foi vinculado a um objeto de conta do computador no AD DS (Active Directory Domain Servers). Os clientes pré-testados são também chamados de computadores conhecidos. Você pode configurar propriedades na conta do computador 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 [Options] /Set-Device /Device:<Device name> [/ID:<UUID | MAC address>] [/ReferralServer:<Server name>] [/BootProgram:<Relative path>]
[/WdsClientUnattend:<Relative path>] [/User:<Domain\User | User@Domain>] [/JoinRights:{JoinOnly | Full}] [/JoinDomain:{Yes | No}] [/BootImagepath:<Relative path>] [/Domain:<Domain>] [/resetAccount]

Parâmetros

Parâmetro Descrição
/Device:<nome do computador> Especifica o nome do computador (SAM-Account-Name).
[/ID:<UUID | endereço MAC>] Especifica o GUID/UUID ou o endereço MAC do computador. Esse valor deve estar em um dos três seguintes formatos:

- Cadeia de caracteres binária: /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6
- Cadeia de caracteres GUID/UUID: /ID:E8A3EFAC-201F-4E69-953E-B2DAA1E8B1B6
- Endereço MAC: 00B056882FDC (sem traços) ou 00-B0-56-88-2F-DC (com traços)

[/ReferralServer:<Nome do servidor>] 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 (Trivial File Transfer Protocol).
[/BootProgram:<Caminho relativo>] Especifica o caminho relativo da pasta remoteInstall para o programa de inicialização de rede que o computador especificado receberá. Por exemplo: boot\x86\pxeboot.com
[/WdsClientUnattend:<Caminho relativo>] Especifica o caminho relativo da pasta remoteInstall para o arquivo unattend que automatiza as telas de instalação do cliente dos Serviços de Implantação do Windows.
[/User:<Domain\User | Usuário@Domínio>] 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, incluindo o direito de ingressar o computador no domínio.

[/JoinDomain:{Yes | No}] Especifica se o computador deve ou não ser ingressado no domínio como essa conta de computador durante uma instalação dos Serviços de Implantação do Windows. A configuração padrão é Sim.
[/BootImagepath:<Caminho relativo>] Especifica o caminho relativo da pasta remoteInstall para a imagem de inicialização e este computador usará.
[/Domain:<Domínio>] Especifica o domínio a ser pesquisado para o computador preparado previamente. O valor padrão é o domínio local.
[/resetAccount] redefine as permissões no computador especificado para que toda pessoa com as permissões apropriadas possa ingressar no domínio usando essa conta.

Exemplos

Para definir o programa de inicialização de rede e o servidor de referência para um computador, digite:

wdsutil /Set-Device /Device:computer1 /ReferralServer:MyWDSServer
/BootProgram:boot\x86\pxeboot.n12

Para definir várias configurações para um computador, digite:

wdsutil /verbose /Set-Device /Device:computer2 /ID:00-B0-56-88-2F-DC /WdsClientUnattend:WDSClientUnattend\unattend.xml
/User:Domain\user /JoinRights:JoinOnly /JoinDomain:No /BootImagepath:boot\x86\images\boot.wim /Domain:NorthAmerica /resetAccount