大网数据广告活动
Windows排障命令

wdsutil add-device

· 52CE 我爱测

Reference article for the wdsutil add-device command, which pre-stages a computer in Active Directory Domain Services.

Pre-stages a computer in Active Directory Domain Services (AD DS). Pre-staged 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.

Syntax

wdsutil /add-Device /Device:<Devicename> /ID:<UUID | MAC address> [/ReferralServer:<Servername>] [/BootProgram:<Relativepath>] [/WdsClientUnattend:<Relativepath>] [/User:<Domain\User | User@Domain>] [/JoinRights:{JoinOnly | Full}] [/JoinDomain:{Yes | No}] [/BootImagepath:<Relativepath>] [/OU:<DN of OU>] [/Domain:<Domain>]

Parameters

Parameter Description
/Device:<Devicename> Specifies the name of the device to be added.
/ID:`<UUID MAC address>`
[/ReferralServer:<Servername>] 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:<Relativepath>] 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:<Relativepath>] 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>`]
[/JoinRights:`{JoinOnly Full}`]
[/JoinDomain:`{Yes No}`]
[/BootImagepath:<Relativepath>] 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

Related links

Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors (upstream author metadata: robinharwood). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Server documentation
适用范围
Windows Server · Source date 10/16/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。