/set-Device
Applies To: Windows Server 2008, Windows Server 2008 R2
Changes the attributes of a prestaged computer. A prestaged computer is a computer that has been linked to a computer account object in Active Directory Domain Servers (AD DS). Prestaged clients are also called known computers. You can configure properties on the computer account to control the installation for the client. For example, you can configure the network boot program and the unattend file that the client should receive, as well as the server from which the client should download the network boot program.
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:<computer name> |
Specifies the name of the computer (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 computer 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 computer to the domain. |
[/JoinRights:{JoinOnly | Full}] |
Specifies the type of rights to be assigned to the user.
|
[/JoinDomain:{Yes | No}] |
Specifies whether or not the computer 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 computer will use. |
[/Domain:<Domain>] |
Specifies the domain to be searched for the prestaged computer. The default value is the local domain. |
[/ResetAccount] |
Resets the permissions on the specified computer 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 computer, type:
WDSUTIL /Set-Device /Device:Computer1 /ReferralServer:MyWDSServer
/BootProgram:boot\x86\pxeboot.n12
To set various settings for a computer, 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