Partager via

wdsutil set-server

Configure les paramètres d’un serveur des services de déploiement Windows.

Syntaxe

wdsutil [Options] /Set-Server [/Server:<Server name>]
    [/Authorize:{Yes | No}]
    [/RogueDetection:{Yes | No}]
    [/AnswerClients:{All | Known | None}]
    [/Responsedelay:<time in seconds>]
    [/AllowN12forNewClients:{Yes | No}]
    [/ArchitectureDiscovery:{Yes | No}]
    [/resetBootProgram:{Yes | No}]
    [/DefaultX86X64Imagetype:{x86 | x64 | Both}]
    [/UseDhcpPorts:{Yes | No}]
    [/DhcpOption60:{Yes | No}]
    [/RpcPort:<Port number>]
    [/PxepromptPolicy
        [/Known:{OptIn | Noprompt | OptOut}]
        [/New:{OptIn | Noprompt | OptOut}]
    [/BootProgram:<Relative path>]
         /Architecture:{x86 | ia64 | x64}
    [/N12BootProgram:<Relative path>]
         /Architecture:{x86 | ia64 | x64}
    [/BootImage:<Relative path>]
         /Architecture:{x86 | ia64 | x64}
    [/PreferredDC:<DC Name>]
    [/PreferredGC:<GC Name>]
    [/PrestageUsingMAC:{Yes | No}]
    [/NewMachineNamingPolicy:<Policy>]
    [/NewMachineOU]
         [/type:{Serverdomain | Userdomain | UserOU | Custom}]
         [/OU:<Domain name of OU>]
    [/DomainSearchOrder:{GCOnly | DCFirst}]
    [/NewMachineDomainJoin:{Yes | No}]
    [/OSCMenuName:<Name>]
    [/WdsClientLogging]
         [/Enabled:{Yes | No}]
         [/LoggingLevel:{None | Errors | Warnings | Info}]
    [/WdsUnattend]
         [/Policy:{Enabled | Disabled}]
         [/CommandlinePrecedence:{Yes | No}]
         [/File:<path>]
             /Architecture:{x86 | ia64 | x64}
    [/AutoaddPolicy]
         [/Policy:{AdminApproval | Disabled}]
         [/PollInterval:{time in seconds}]
         [/MaxRetry:{Retries}]
         [/Message:<Message>]
         [/RetentionPeriod]
             [/Approved:<time in days>]
             [/Others:<time in days>]
    [/AutoaddSettings]
         /Architecture:{x86 | ia64 | x64}
         [/BootProgram:<Relative path>]
         [/ReferralServer:<Server name>
         [/WdsClientUnattend:<Relative path>]
         [/BootImage:<Relative path>]
         [/User:<Owner>]
         [/JoinRights:{JoinOnly | Full}]
         [/JoinDomain:{Yes | No}]
    [/BindPolicy]
         [/Policy:{Include | Exclude}]
         [/add]
              /address:<IP or MAC address>
              /addresstype:{IP | MAC}
         [/remove]
              /address:<IP or MAC address>
              /addresstype:{IP | MAC}
    [/RefreshPeriod:<time in seconds>]
    [/BannedGuidPolicy]
         [/add]
              /Guid:<GUID>
         [/remove]
             /Guid:<GUID>
    [/BcdRefreshPolicy]
         [/Enabled:{Yes | No}]
         [/RefreshPeriod:<time in minutes>]
    [/Transport]
         [/ObtainIpv4From:{Dhcp | Range}]
             [/start:<start IP address>]
             [/End:<End IP address>]
         [/ObtainIpv6From:Range]
             [/start:<start IP address>]
             [/End:<End IP address>]
         [/startPort:<start Port>
             [/EndPort:<start Port>
        [/Profile:{10Mbps | 100Mbps | 1Gbps | Custom}]
        [/MulticastSessionPolicy]
             [/Policy:{None | AutoDisconnect | Multistream}]
                 [/Threshold:<Speed in KBps>]
                 [/StreamCount:{2 | 3}]
                 [/Fallback:{Yes | No}]
        [/forceNative]

Paramètres

Paramètre Description
[/Server:<Nom du serveur>] Spécifie le nom du serveur. Cela peut être le nom NetBIOS ou le nom FQDN. Si aucun nom de serveur n’est spécifié, le serveur local est utilisé.
[/Authorize:{Yes | No}] Spécifie s’il faut autoriser ce serveur dans le protocole DHCP (Dynamic Host Control Protocol).
[/RogueDetection:{Yes | No}] Active ou désactive la détection de serveurs non autorisés DHCP.
[/AnswerClients:{All | Known | None}] Spécifie les clients auxquels ce serveur répondra. Si vous définissez cette valeur sur Known, un ordinateur doit être préparé dans Active Directory Domain Services (AD DS) avant d’être traité par le serveur des services de déploiement Windows.
[/Responsedelay:<time in seconds>] Durée pendant laquelle le serveur attend avant de répondre à un client de démarrage. Ce paramètre ne s’applique pas aux ordinateurs préconfigurés.
[/AllowN12forNewClients:{Yes | No}] Pour Windows Server 2008, spécifie que les clients inconnus n’auront pas besoin d’appuyer sur la touche F12 pour lancer un démarrage réseau. Les clients connus recevront le programme de démarrage spécifié pour l’ordinateur ou, s’il n’est pas spécifié, le programme de démarrage spécifié pour l’architecture.

Pour Windows Server 2008 R2, cette option a été remplacée par la commande suivante : wdsutil /Set-Server /PxepromptPolicy /New:Noprompt
[/ArchitectureDiscovery:{Yes | No}] Active ou désactive la découverte de l’architecture. Cela facilite la découverte des clients x64 qui ne diffusent pas correctement leur architecture.
[/resetBootProgram:{Yes | No}] Détermine si le chemin de démarrage sera effacé pour un client qui vient de démarrer sans appuyer sur la touche F12.
[/DefaultX86X64Imagetype: {x86 | x64 | Both}] Contrôle les images de démarrage qui seront affichées aux clients x64.
[/UseDhcpPorts:{Yes | No}] Spécifie si le serveur PXE doit tenter de lier le port DHCP, port TCP 67. Si les services de déploiement DHCP et Windows s’exécutent sur le même ordinateur, vous devez définir cette option sur No pour permettre au serveur DHCP d’utiliser le port et définir le paramètre /DhcpOption60 sur Yes. Le paramètre par défaut de cette valeur est Yes.
[/DhcpOption60:{Yes | No}] Spécifie si l’option DHCP 60 doit être configurée pour la prise en charge de PXE. Si les services de déploiement DHCP et Windows s’exécutent sur le même serveur, définissez cette option sur Yes et définissez l’option /UseDhcpPorts sur No. Le paramètre par défaut de cette valeur est No.
[/RpcPort:<Numéro de port>] Spécifie le numéro de port TCP à utiliser pour traiter les requêtes du client.
[/PxepromptPolicy] Configure la façon dont les clients connus (préparés) et nouveaux lancent un démarrage PXE. Cette option s’applique uniquement à Windows Server 2008 R2. Vous définissez les paramètres à l’aide des options suivantes :

- [/Known:{OptIn| OptOut| Noprompt}] : définit la stratégie pour les clients préparés.
- [/New:{OptIn|OptOut|Noprompt}] : définit la stratégie pour les nouveaux clients.

OptIn signifie que le client doit appuyer sur une touche pour démarrer PXE. Sinon, il revient au périphérique de démarrage suivant.

Noprompt signifie que le client va toujours démarrer PXE.

OptOut signifie que le client démarre PXE, sauf si la touche Échap est enfoncée.
[/BootProgram :<>Chemin relatif] /Architecture :{x86 | ia64 | x64} Spécifie le chemin relatif du programme de démarrage dans le dossier remoteInstall (par exemple, boot\x86\pxeboot.n12) et spécifie l’architecture du programme de démarrage.
[/N12BootProgram :<>Chemin relatif] /Architecture :{x86 | ia64 | x64} Spécifie le chemin d’accès relatif au programme de démarrage qui ne nécessite pas d’appuyer sur la touche F12 (par exemple, boot\x86\pxeboot.n12) et spécifie l’architecture du programme de démarrage.
[/BootImage :<>Chemin relatif] /Architecture :{x86 | ia64 | x64} Spécifie le chemin d’accès relatif à l’image de démarrage que les clients de démarrage doivent recevoir et spécifie l’architecture de l’image de démarrage. Vous pouvez le spécifier pour chaque architecture.
[/PreferredDC :< Nom du contrôleur de domaine>] Spécifie le nom du contrôleur de domaine que les services de déploiement Windows doivent utiliser. Cela peut être le nom NetBIOS ou le FQDN.
[/PreferredGC :<Nom du catalogue>] Spécifie le nom du serveur de catalogue global que les services de déploiement Windows doivent utiliser. Cela peut être le nom NetBIOS ou le FQDN.
[/PrestageUsingMAC:{Yes | No}] Spécifie si les services de déploiement Windows, lors de la création de comptes d’ordinateur dans AD DS, doivent utiliser l’adresse MAC plutôt que le GUID/UUID pour identifier l’ordinateur.
[/NewMachineNamingPolicy:<Stratégie>] Spécifie le format à utiliser lors de la génération de noms d’ordinateurs pour les clients. Pour plus d’informations sur le format à utiliser pour la <stratégie>, cliquez avec le bouton droit sur le serveur dans le composant logiciel enfichable mmc, cliquez sur Propriétés, puis affichez l’onglet Services de répertoire. Par exemple, /NewMachineNamingPolicy: %61Username%#.
[/NewMachineOU] Permet de spécifier l’emplacement dans AD DS où les comptes d’ordinateurs clients sont créés. Vous spécifiez l’emplacement à l’aide des options suivantes.

- [/type: Serverdomain | Userdomain | UserOU | Custom ] Spécifie le type d’emplacement. Serverdomain crée des comptes dans le même domaine que le serveur des services de déploiement Windows. Userdomain crée des comptes dans le même domaine que l’utilisateur effectuant l’installation. UserOU crée des comptes dans l’unité d’organisation de l’utilisateur qui effectue l’installation. Custom vous permet de spécifier un emplacement personnalisé (vous devez également spécifier une valeur pour /OU avec cette option).
- [/OU:<Nom de domaine de l’unité d’organisation>] : si vous spécifiez Custom pour l’option /type, cette option spécifie l’unité d’organisation dans laquelle les comptes d’ordinateur doivent être créés.
[/DomainSearchOrder:{GCOnly | DCFirst}] Spécifie la stratégie de recherche de comptes d’ordinateur dans AD DS (catalogue global ou contrôleur de domaine).
[/NewMachineDomainJoin:{Yes | No}] Spécifie si un ordinateur qui n’est pas déjà préparé dans AD DS doit être joint au domaine pendant l’installation. La valeur par défaut est Oui.
[/WdsClientLogging] Spécifie le niveau de journalisation du serveur.

- [/Enabled:{Yes | No}] : active ou désactive la journalisation des actions clientes des services de déploiement Windows.
- [/LoggingLevel : {None | Errors | Warnings | Info} : définit le niveau de journalisation. None équivaut à désactiver la journalisation. Errors équivaut au niveau de journalisation le plus bas et indique que seules les erreurs seront enregistrées. Warnings inclut les avertissements et les erreurs. Info équivaut au niveau de journalisation le plus élevé et inclut des erreurs, des avertissements et des événements d’informations.
[/WdsUnattend] Ces paramètres contrôlent le comportement d’installation sans assistance du client des services de déploiement Windows. Vous définissez les paramètres à l’aide des options suivantes :

- [/Policy:{Enabled | Disabled}] : spécifie si l’installation sans assistance est utilisée.
- [/CommandlinePrecedence: {Yes | No}] : spécifie si un fichier Autounattend.xml (s’il est présent sur le client) ou un fichier d’installation sans assistance qui a été transmis directement au client des services de déploiement Windows avec l’option /Unattend sera utilisé à la place d’un fichier sans assistance d’image lors de l’installation d’un client. Le paramètre par défaut est No.
- [/File:<Chemin relatif> /Architecture:{x86 | ia64 | x64}] : spécifie le nom de fichier, le chemin d’accès et l’architecture du fichier sans assistance.
[/AutoaddPolicy] Ces paramètres contrôlent la stratégie d’ajout automatique. Vous définissez les paramètres à l’aide des options suivantes :

- [/Policy: {AdminApproval | Disabled}] : AdminApprove entraîne l’ajout de tous les ordinateurs inconnus à une file d’attente, où l’administrateur peut ensuite examiner la liste des ordinateurs et approuver ou rejeter chaque requête, le cas échéant. Disabled indique qu’aucune action supplémentaire n’est effectuée lorsqu’un ordinateur inconnu tente de démarrer sur le serveur.
- [/PollInterval:{time in seconds}] : spécifie l’intervalle (en secondes) auquel le programme de démarrage réseau doit interroger le serveur des services de déploiement Windows.
- [/MaxRetry: <Numéro>] : spécifie le nombre de fois où le programme de démarrage réseau doit interroger le serveur des services de déploiement Windows. Cette valeur, ainsi que /PollInterval, dicte la durée pendant laquelle le programme de démarrage réseau attendra qu’un administrateur approuve ou rejette l’ordinateur avant d’expirer. Par exemple, une valeur MaxRetry de 10 et une valeur PollInterval de 60 indiquent que le client doit interroger le serveur 10 fois, en attendant 60 secondes entre chaque tentative. Par conséquent, le client expire après 10 minutes (10 x 60 secondes = 10 minutes).
- [/Message: <Message>] : spécifie le message qui s’affiche pour le client dans la boîte de dialogue du programme de démarrage réseau.
- [/RetentionPeriod] : spécifie le nombre de jours pendant lesquels un ordinateur peut se trouver dans un état d’attente avant d’être automatiquement vidé.
- [/Approved: <durée en jours>] : spécifie la période de rétention pour les ordinateurs approuvés. Vous devez utiliser ce paramètre avec l’option /RetentionPeriod.
- [/Others: <durée en jours>] : spécifie la période de rétention pour les ordinateurs non approuvés (rejetés ou en attente). Vous devez utiliser ce paramètre avec l’option /RetentionPeriod.
[/AutoaddSettings] Spécifie les paramètres par défaut à appliquer à chaque ordinateur. Vous définissez les paramètres à l’aide des options suivantes :

- /Architecture: {x86 | ia64 | x64} : spécifie l’architecture.
- [/BootProgram: <Chemin relatif>] : spécifie le programme de démarrage envoyé à l’ordinateur approuvé. Si aucun programme de démarrage n’est spécifié, la valeur par défaut de l’architecture de l’ordinateur (comme spécifié sur le serveur) est utilisée.
- [/WdsClientUnattend: <Chemin relatif>] : définit le chemin d’accès relatif au fichier sans assistance que le client approuvé doit recevoir.
- [/ReferralServer: <Nom du serveur>] : spécifie le serveur des services de déploiement Windows que le client utilise pour télécharger des images.
- [/BootImage: <Chemin relatif>] : spécifie l’image de démarrage que le client approuvé reçoit.
- [/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 | No}] : 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.
[/BindPolicy] Configure les interfaces réseau pour que le fournisseur PXE écoute. Vous définissez les stratégies à l’aide des options suivantes :

- [/Policy: {Include | Exclude}] : définit la stratégie de liaison d’interface pour inclure ou exclure les adresses de la liste d’interface.
- [/add] : ajoute une interface à la liste. Vous devez également spécifier /addresstype et /address.
- [/remove] : supprime une interface de la liste. Vous devez également spécifier /addresstype et /address.
- /address:<adresse IP ou MAC> : spécifie l’adresse IP ou MAC de l’interface à ajouter ou à supprimer.
- /addresstype: {IP | MAC} : indique le type d’adresse spécifié dans l’option /address.
[/RefreshPeriod: <secondes>] Spécifie la fréquence (en secondes) que le serveur actualise ses paramètres.
[/BannedGuidPolicy] Gère la liste des GUID interdits à l’aide des options suivantes :

- [/add] /Guid:<GUID> : ajoute le GUID spécifié à la liste des GUID interdits. Tout client avec ce GUID sera identifié par son adresse MAC à la place.
- [/remove] /Guid:<GUID> : supprime le GUID spécifié de la liste des GUID interdits.
[/BcdRefreshPolicy] Configure les paramètres d’actualisation des fichiers Bcd à l’aide des options suivantes :

- [/Enabled:{Yes | No}] : spécifie la stratégie d’actualisation Bcd. Lorsque /Enabled a la valeur Yes, les fichiers Bcd sont actualisés à l’intervalle de temps spécifié.
- [/RefreshPeriod:<durée en minutes>] : spécifie l’intervalle de temps auquel les fichiers Bcd sont actualisés.
[/Transport] Configure les options suivantes :

  • [/ObtainIpv4From: {Dhcp | Range}] : spécifie la source des adresses IPv4.

    • [/start: <début de l’adresse Ipv4>] : spécifie le début de la plage d’adresses IP. Cette option est obligatoire et valide uniquement si /ObtainIpv4From est défini sur Range.
    • [/End: <Fin de l’adresse Ipv4>] : spécifie la fin de la plage d’adresses IP. Cette option est obligatoire et valide uniquement si /ObtainIpv4From est défini sur Range.
  • [/ObtainIpv6From:Range] [/start:<début de l’adresse IP>] [/End: <fin de l’adresse IP>] : spécifie la source des adresses IPv6. Cette option s’applique uniquement à Windows Server 2008 R2 et la seule valeur prise en charge est Range.
  • [/startPort: <début du port>] : spécifie le début de la plage de ports.
  • [/EndPort: <fin du port>] : spécifie la fin de la plage de ports.
  • [/Profile: {10Mbps | 100Mbps | 1Gbps | Custom}] : spécifie le profil réseau à utiliser. Cette option est uniquement prise en charge pour les serveurs exécutant Windows Server 2008.
  • [/MulticastSessionPolicy] : configure les paramètres de transfert pour les transmissions multidiffusion. Cette commande est disponible uniquement pour Windows Server 2008 R2.

    • [/Policy:{None | AutoDisconnect | Multistream}] : détermine comment gérer les clients lents. None signifie conserver tous les clients dans une session à la même vitesse. AutoDisconnect signifie que tous les clients qui passent en dessous du /Threshold spécifié sont déconnectés. Multistream signifie que les clients seront séparés en plusieurs sessions, comme spécifié par /StreamCount.
    • [/Threshold:<Vitesse en KBits/s>] : pour /Policy:AutoDisconnect, cette option définit le taux de transfert minimal en KBits/s. Les clients qui descendent en dessous de ce taux seront déconnectés des transmissions multidiffusion.
    • [/StreamCount:{2 | 3}] [/Fallback:{Yes | No}] : pour /Policy:Multistream, cette option détermine le nombre de sessions. 2 signifie deux sessions (rapides et lentes), 3 signifie trois sessions (lentes, moyennes, rapides).
    • [/Fallback:{Yes | No}] : détermine si les clients déconnectés continueront le transfert à l’aide d’une autre méthode (si prise en charge par le client). Si vous utilisez le client WDS, l’ordinateur est de retour vers la monodiffusion. Wdsmcast.exe ne prend pas en charge un mécanisme de secours. Cette option s’applique également aux clients qui ne prennent pas en charge Multistream. Dans ce cas, l’ordinateur utilise une autre méthode au lieu de passer à une session de transfert plus lente.

Exemples

Pour définir le serveur pour répondre uniquement aux clients connus, avec un délai de réponse de 4 minutes, saisissez :

wdsutil /Set-Server /AnswerClients:Known /Responsedelay:4

Pour définir le programme de démarrage et l’architecture du serveur, saisissez :

wdsutil /Set-Server /BootProgram:boot\x86\pxeboot.n12 /Architecture:x86

Pour activer la journalisation sur le serveur, saisissez :

wdsutil /Set-Server /WdsClientLogging /Enabled:Yes /LoggingLevel:Warnings

Pour activer unattend sur le serveur, ainsi que l’architecture et le fichier client unattend, saisissez :

wdsutil /Set-Server /WdsUnattend /Policy:Enabled /File:WDSClientUnattend \unattend.xml /Architecture:x86

Pour définir le serveur PXE (Pre-Boot Execution Environment) de manière à ce qu’il tente de se lier aux ports TCP 67 et 60, saisissez :

wdsutil /Set-server /UseDhcpPorts:No /DhcpOption60:Yes