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:
|
[/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.
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