wdsutil set-device

S’applique à : Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Modifie les attributs d’un ordinateur préparé. Un ordinateur préparé est un ordinateur qui a été lié à un objet de compte d’ordinateur dans les serveurs de domaine Active Directory (AD DS). Les clients prédéfinis sont également appelés ordinateurs connus. Vous pouvez configurer les propriétés du compte d'ordinateur afin de contrôler l'installation du client. Par exemple, vous pouvez configurer le programme de démarrage réseau et le fichier d’installation sans assistance que le client reçoit, ainsi que le serveur à partir duquel le client télécharge le programme de démarrage de réseau.

Syntaxe

wdsutil [Options] /Set-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>] [/Domain:<Domain>] [/resetAccount]

Paramètres

Paramètre Description
/Device:<computer name> Spécifie le nom de l’ordinateur (SAM-Account-Name).
[/ID:<UUID | MAC address>] Spécifie le GUID/UUID ou l’adresse MAC de l’ordinateur. Cette valeur doit être dans l’un des trois formats suivants :

- Chaîne binaire : /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6
- Chaîne GUID/UUID : /ID:E8A3EFAC-201F-4E69-953E-B2DAA1E8B1B6
- Adresse MAC : 00B056882FDC (sans tirets) ou 00-B0-56-88-2F-DC (avec tirets)

[/ReferralServer :<Server name>] Spécifie le nom du serveur à contacter pour télécharger le programme de démarrage réseau et l’image de démarrage à l’aide du protocole tftp (Trivial File Transfer Protocol).
[/BootProgram:<Relative path>] Spécifie le chemin d’accès relatif du dossier remoteInstall au programme de démarrage réseau que l’ordinateur recevra. Par exemple : boot\x86\pxeboot.com
[/WdsClientUnattend:<Relative path>] Spécifie le chemin d’accès relatif du dossier remoteInstall au fichier sans assistance qui automatise les écrans d’installation du client des services de déploiement Windows.
[/User:<Domain\User | User@Domain>] Définit les autorisations sur l’objet de compte d’ordinateur pour donner à l’utilisateur spécifié les droits nécessaires pour joindre l’ordinateur au domaine.
[/JoinRights:{JoinOnly | Full}] Spécifie le type de droits à attribuer à l’utilisateur.

- JoinOnly exige que l’administrateur réinitialise le compte d’ordinateur avant que l’utilisateur puisse joindre l’ordinateur au domaine.
- Full donne un accès complet à l’utilisateur, ce qui inclut le droit de joindre l’ordinateur au domaine.

[/JoinDomain :{Yes | Non}] Spécifie si l’ordinateur doit ou non être joint au domaine en tant que compte d’ordinateur lors d’une installation des services de déploiement Windows. La valeur par défaut est Oui.
[/BootImagepath:<Relative path>] Spécifie le chemin d’accès relatif du dossier remoteInstall à l’image de démarrage que cet ordinateur utilisera.
[/Domain :<Domain>] Spécifie le domaine à rechercher pour l’ordinateur préparé. La valeur par défaut est l'ordinateur local.
[/resetAccount] réinitialise les autorisations sur l’ordinateur spécifié afin que toute personne disposant des autorisations appropriées puisse rejoindre le domaine à l’aide de ce compte.

Exemples

Pour définir le programme de démarrage réseau et le serveur de référence pour un ordinateur, tapez :

wdsutil /Set-Device /Device:computer1 /ReferralServer:MyWDSServer
/BootProgram:boot\x86\pxeboot.n12

Pour définir différents paramètres pour un ordinateur, tapez :

wdsutil /verbose /Set-Device /Device:computer2 /ID:00-B0-56-88-2F-DC /WdsClientUnattend:WDSClientUnattend\unattend.xml
/User:Domain\user /JoinRights:JoinOnly /JoinDomain:No /BootImagepath:boot\x86\images\boot.wim /Domain:NorthAmerica /resetAccount