Utilisation de l’API du client des Services de déploiement Windows

  • Article

Dans les environnements où une solution standard des services de déploiement Windows (WDS) ne peut pas être utilisée pour installer Windows, l’API du client WDS permet aux développeurs d’écrire des applications de déploiement personnalisées. Les applications peuvent utiliser cette API pour communiquer avec le serveur WDS afin d’obtenir des informations sur les images système disponibles à partir du serveur. Les applications clientes WDS personnalisées doivent respecter les instructions suivantes.

Installer le rôle WDS sur le serveur

  • Les services de déploiement Windows (WDS) sont la version révisée des services d’installation à distance (RIS). Vous aurez besoin du rôle serveur WDS sur le serveur pour implémenter des solutions clientes WDS personnalisées.
  • WDS remplace RIS en tant que composant standard à partir de Windows Server 2008 et Windows Server 2003 avec Service Pack 2 (SP2).
  • Vous devez mettre à jour le serveur RIS vers WDS sur Windows Server 2003 avec Service Pack 1 (SP1). Vous pouvez installer le rôle serveur WDS avec le Kit d'installation automatisée (Windows AIK) (WAIK).

Démarrer Windows PE 2.0

Windows PE 2.0 doit être démarré, s’il n’est pas déjà démarré. Le client WDS et les DLL de prise en charge sont uniquement chargés par setup.exe lorsqu’il se trouve dans la phase de traitement de l’installation de Microsoft Windows Preinstallation Environment (Windows PE 2.0).

  • Lorsqu’un nouvel ordinateur est connecté au réseau, la technologie PXE (preboot execution environment) intégrée peut être utilisée pour télécharger le programme de démarrage réseau. Pour plus d’informations sur le démarrage PXE d’un ordinateur pour installer Windows, consultez le Guide pas à pas des mises à jour des services de déploiement Windows.
  • Une image de démarrage RAMDISK de Windows PE 2.0 peut être stockée dans le . Format WIM et téléchargé dans le cadre du processus de démarrage réseau. Windows PE peut ensuite être chargé et exécuté directement à partir de ce média.

Ouvrir une session avec le serveur WDS

Le client WDS doit ouvrir une session avec un serveur WDS.

  • Utilisez la fonction WdsCliCreateSession pour ouvrir une session avec un serveur WDS. Cette fonction prend le nom ou l’adresse IP du serveur et reçoit l’adresse du handle pour la session client WDS.
  • Si l’ouverture de la session avec le serveur nécessite l’authentification du client WDS, l’application doit fournir l’adresse d’une structure WDS_CLI_CRED contenant les informations d’identification du client lors de l’appel de la fonction WdsCliCreateSession . L’application peut utiliser la fonction WdsCliAuthorizeSession pour convertir une session anonyme en session authentifiée.
  • Lorsque la session ouverte avec la fonction WdsCliCreateSession n’est plus nécessaire, l’application doit utiliser la fonction WdsCliClose pour fermer le handle et libérer les ressources détenues par la session.

Énumérer les images système sur le serveur WDS

Le client WDS peut utiliser l’API pour énumérer les images système sur le serveur WDS.

  • Utilisez la fonction WdsCliFindFirstImage pour obtenir un handle pour la première image et initialiser l’énumération des images sur le serveur WDS.
  • Utilisez la fonction WdsCliFindNextImage pour incrémenter l’énumération démarrée par la fonction WdsCliFindFirstImage . La fonction WdsCliFindNextImage obtient le handle de l’image suivante.
  • Utilisez la fonction WdsCliGetImageIndex pour obtenir l’index d’image de l’image actuelle. Cette valeur n’est valide que jusqu’à ce que les fonctions WdsCliFindNextImage ou WdsCliClose soient à nouveau utilisées.
  • Utilisez la fonction WdsCliGetEnumerationFlags pour obtenir des indicateurs d’information sur le filtrage d’images.

Obtenir des informations sur les images

Le client WDS peut utiliser l’API pour obtenir des informations sur les images sur un serveur WDS. Les fonctions suivantes obtiennent des informations sur l’image actuelle. Étant donné que les fonctions WdsCliFindFirstImage et WdsCliFindNextImage modifient la valeur de handle d’image actuelle, l’application doit stocker toutes les informations qu’elle obtient et aura besoin à l’avenir avant d’appeler à nouveau les fonctions WdsCliFindFirstImage ou WdsCliFindNextImage .

Journaliser les événements du client WDS

La fonctionnalité de journalisation de la bibliothèque cliente WDS permet d’envoyer des événements de progression de l’installation du client au serveur WDS.

  • Utilisez la fonction WdsCliInitializeLog pour initialiser le journal de la session cliente WDS.
  • Utilisez la fonction WdsCliLog pour écrire des messages d’événement dans le journal du serveur WDS.
  • Sur Windows Server 2008, le serveur WDS écrit les événements clients dans un journal des événements spécifique à l’application qui est visible via eventvwr.exe ainsi que le journal de trace de débogage. Sur Windows Server 2003 avec la journalisation du débogage activée, le serveur WDS écrit les événements client dans le fichier journal situé à l’emplacement %windir%\tracing\wdsserver.log. La journalisation du client WDS doit être activée sur le serveur pour capturer ces événements.

À propos de l’API Des services de déploiement Windows

Utilisation de l’API du serveur des Services de déploiement Windows