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