Share via


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

  • 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 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.

  • 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 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

Additional references

Command-Line Syntax Key

/add-Device

/get-AllDevices

/get-Device