WDSUTIL-Add-Devicewdsutil add-device

Gilt für: Windows Server (halbjährlicher Kanal), Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012Applies to: Windows Server (Semi-Annual Channel), Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Vorab Stufen eines Computers in Active Directory Domain Services (AD DS).Pre-stages a computer in Active Directory Domain Services (AD DS). Vorab bereitgestellte Computer werden auch als bekannte Computerbezeichnet.Pre-staged computers are also called known computers. Dadurch können Sie Eigenschaften konfigurieren, um die Installation für den Client zu steuern.This allows you to configure properties to control the installation for the client. Beispielsweise können Sie das Netzwerkstart Programm und die Datei für die unbeaufsichtigte Installation konfigurieren, die vom Client empfangen werden soll, sowie den Server, von dem der Client das Netzwerkstart Programm herunterladen soll.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.

SyntaxSyntax

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

ParameterParameters

ParameterParameter BESCHREIBUNGDescription
Schutz<Devicename>/Device:<Devicename> Gibt den Namen des hinzu zufügenden Geräts an.Specifies the name of the device to be added.
Name<UUID|MAC address>/ID:<UUID|MAC address> Gibt entweder die GUID/UUID oder die Mac-Adresse des Computers an.Specifies either the GUID/UUID or the MAC address of the computer. Eine GUID/UUID muss eines von zwei Formaten aufweisen: binäre Zeichenfolge ( /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6 ) oder GUID-Zeichenfolge ( /ID:E8A3EFAC-201F-4E69-953E-B2DAA1E8B1B6 ).A GUID/UUID must be in one of two formats: Binary string (/ID:ACEFA3E81F20694E953EB2DAA1E8B1B6) or GUID string (/ID:E8A3EFAC-201F-4E69-953E-B2DAA1E8B1B6). Eine Mac-Adresse muss folgendes Format aufweisen: 00b056882( keine Bindestriche) oder 00-B0-56-88-2F-DC (mit Bindestrichen)A MAC address must be in the following format: 00B056882FDC (no dashes) or 00-B0-56-88-2F-DC (with dashes)
[/ReferralServer: <Servername> ][/ReferralServer:<Servername>] Gibt den Namen des Servers an, für den eine Verbindung hergestellt werden soll, um das Netzwerkstart Programm und das Start Abbild mit Trivial File Transfer Protocol (TFTP) herunterzuladen.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> ][/BootProgram:<Relativepath>] Gibt den relativen Pfad vom Ordner RemoteInstall zum Netzwerkstart Programm an, das von diesem Computer empfangen werden soll.Specifies the relative path from the remoteInstall folder to the network boot program that this computer should receive. Beispiel: boot\x86\pxeboot.comFor example: boot\x86\pxeboot.com
[/WdsClientUnattend: <Relativepath> ][/WdsClientUnattend:<Relativepath>] Gibt den relativen Pfad vom Ordner RemoteInstall zur unbeaufsichtigten Installationsdatei an, mit der die Installations Bildschirme des Windows-Bereitstellungsdiensteclient automatisiert werden.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> ][/User:<Domain\User|User@Domain>] Legt Berechtigungen für das Computer Konto Objekt fest, um dem angegebenen Benutzer die erforderlichen Rechte zum Hinzufügen des Computers zur Domäne zu übergeben.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} ][/JoinRights:{JoinOnly|Full}] Gibt den Typ der Rechte an, die dem Benutzer zugewiesen werden sollen.Specifies the type of rights to be assigned to the user.
  • Joinonly : der Administrator muss das Computer Konto zurücksetzen, bevor der Benutzer den Computer der Domäne hinzufügen kann.JoinOnly - Requires the administrator to reset the computer account before the user can join the computer to the domain.
  • Full : bietet vollständigen Zugriff auf den Benutzer, der über das Recht zum Hinzufügen des Computers zur Domäne verfügt.Full - Gives full access to the user, which includes the right to join the computer to the domain.
[/JoinDomain: {Yes|No} ][/JoinDomain:{Yes|No}] Gibt an, ob der Computer während der Installation des Betriebssystems mit der Domäne verknüpft werden soll.Specifies whether the computer should be joined to the domain as this computer account during operating system installation. Der Standardwert ist Ja.The default value is Yes.
[/BootImagepath: <Relativepath> ][/BootImagepath:<Relativepath>] Gibt den relativen Pfad vom Ordner RemoteInstall zum Start Abbild an, das von diesem Computer verwendet werden soll.Specifies the relative path from the remoteInstall folder to the boot image that this computer should use.
[/Ou: <DN of OU> ][/OU:<DN of OU>] Der Distinguished Name der Organisationseinheit, in der das Computer Konto Objekt erstellt werden soll.The distinguished name of the organizational unit where the computer account object should be created. Beispiel: OU = MyOU, CN = Test, DC = Domain, DC = com.For example: OU=MyOU,CN=Test, DC=Domain,DC=com. Der Standard Speicherort ist der Container des Standard Computers.The default location is the default computer's container.
[/Domain: <Domain> ][/Domain:<Domain>] Die Domäne, in der das Computer Konto Objekt erstellt werden soll.The domain where the computer account object should be created. Der Standard Speicherort ist die lokale Domäne.The default location is the local domain.

BeispieleExamples

Wenn Sie einen Computer mit einer Mac-Adresse hinzufügen möchten, geben Sie Folgendes ein:To add a computer by using a MAC address, type:

wdsutil /add-Device /Device:computer1 /ID:00-B0-56-88-2F-DC

Um einen Computer mithilfe einer GUID-Zeichenfolge hinzuzufügen, geben Sie Folgendes ein: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

Zusätzliche ReferenzenAdditional References