Adds a prestaged device to the directory service.

For examples of how you can use this command, see Examples.

Syntax

WDSUTIL /Add-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>] [/OU:<DN of OU>] [/Domain:<Domain>]

Parameters

Parameter Description

/Device:<Device name>

Specifies the name of the device to be added.

/ID:<UUID | MAC Address>

Specifies either the GUID/UUID or the MAC address of the computer. A GUID/UUID must be in one of two formats—binary string or GUID string. For example:

Binary string: /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6

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

A MAC address must be in the following format: 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 the boot image by using Trivial File Transfer Protocol (TFTP).

[/BootProgram:<Relative path>]

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

[/WdsClientUnattend:<Relative path>]

Specifies the relative path from the RemoteInstall folder to the unattended installation file that automates the installation screens of 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, which includes 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 operating system installation. The default value is Yes.

[/BootImagePath:<Relative path>]

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

[/OU:<DN of OU>]

The distinguished name of the organizational unit where the computer account object should be created. For example: OU=MyOU,CN=Test, DC=Domain,DC=com. The default location is the default computer's container.

[/Domain:<Domain>]

The domain where the computer account object should be created. The default location is the local domain.

Examples

To add a device by using a MAC address, type:

WDSUTIL /Add-Device /Device:Computer1 /ID:00-B0-56-88-2F-DC

To add a device by using a GUID string, type:

WDSUTIL /Add-Device /Device:Computer1 /ID:{E8A3EFAC-201F-4E69-953F-B2DAA1E8B1B6} /ReferralServer:WDSServer1 /BootProgram:boot\x86\pxeboot.com 
/WDSClientUnattend:WDSClientUnattend\unattend.xml /User:Domain\MyUser/JoinRights:Full /BootImagePath:boot\x86\images\boot.wim /OU:"OU=MyOU,CN=Test,DC=Domain,DC=com"