Changes the attributes of a prestaged device.

Syntax

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]

Parameters

Parameter Description

/Device:<Device name>

Specifies the name of the device (SAM-Account-Name).

[/ID:<UUID | MAC address>]

Specifies either the GUID/UUID or the MAC address of the computer. This value must be in one of the following three formats:

  • Binary string: /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6

  • GUID/UUID string: /ID:E8A3EFAC-201F-4E69-953E-B2DAA1E8B1B6

  • MAC address: 00B056882FDC (no dashes) or 00-B0-56-88-2F-DC (with dashes)

[/ReferralServer:<Server name>]

Specifies the name of the server to be contacted to download the network boot program and boot image using Trivial File Transfer Protocol (TFTP).

[/BootProgram:<Relative path>]

Specifies the relative path from the RemoteInstall folder to the network boot program that the specified device will receive. For example: boot\x86\pxeboot.com

[/WdsClientUnattend:<Relative path>]

Specifies the relative path from the RemoteInstall folder to the unattend file that automates the installation screens for the Windows Deployment Services client.

[/User:<Domain\User | User@Domain>]

Sets permissions on the computer account object to give the specified user the necessary rights to join the device to the domain.

[/JoinRights:{JoinOnly | Full}]

Specifies the type of rights to be assigned to the user.

  • JoinOnly requires the administrator to reset the computer account before the user can join the computer to the domain.

Full gives full access to the user, including the right to join the computer to the domain.

[/JoinDomain:{Yes | No}]

Specifies whether or not the device should be joined to the domain as this computer account during a Windows Deployment Services installation. The default setting is Yes.

[/BootImagePath:<Relative path>]

Specifies the relative path from the RemoteInstall folder to the boot image that the device will use.

[/Domain:<Domain>]

Specifies the domain to be searched for the prestaged device. The default value is the local domain.

[/ResetAccount]

Resets the permissions on the specified device so that anyone with the appropriate permissions can join the domain by using this account.

Examples

To set the network boot program and referral server for a device, type:

WDSUTIL /Set-Device /Device:Computer1 /ReferralServer:MyWDSServer
/BootProgram:boot\x86\pxeboot.n12

To set various settings for a device, type:

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