/add-Device

Applies To: Windows Server 2008, Windows Server 2008 R2

Prestages a computer in Active Directory Domain Services. Prestaged computers are also called known computers. This allows you to configure properties 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.

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:<computer name>

Specifies the name of the computer 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 computer 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 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, which includes 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 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 computer 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 computer by using a MAC address, type:

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

To add a computer 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"

Additional references

Command-Line Syntax Key

/get-AllDevices

/get-Device

/set-Device