Verwenden der Client-API der Windows-Bereitstellungsdienste

In Umgebungen, in denen eine standardmäßige WDS-Lösung (Windows Deployment Services) nicht zum Installieren von Windows verwendet werden kann, können Entwickler mit der API des WDS-Clients benutzerdefinierte Bereitstellungsanwendungen schreiben. Anwendungen können diese API für die Kommunikation mit dem WDS-Server verwenden, um Informationen zu vom Server verfügbaren Systemabbildern zu erhalten. Benutzerdefinierte WDS-Clientanwendungen sollten die folgenden Richtlinien einhalten.

Installieren der WDS-Rolle auf dem Server

  • Windows Bereitstellungsdienste (WDS) ist die überarbeitete Version der Remoteinstallationsdienste (Remote Installation Services, RIS). Sie benötigen die WDS-Serverrolle auf dem Server, um benutzerdefinierte WDS-Clientlösungen zu implementieren.
  • WDS ersetzt RIS als Standardkomponente ab Windows Server 2008 und Windows Server 2003 durch Service Pack 2 (SP2).
  • Sie müssen den RIS-Server auf WDS auf Windows Server 2003 mit Service Pack 1 (SP1) aktualisieren. Sie können die WDS-Serverrolle mit dem Windows Automated Installation Kit (TESTSK) installieren.

Starten Windows PE 2.0

Windows PE 2.0 muss gestartet werden, sofern noch nicht gestartet. Der WDS-Client und die unterstützenden DLLs werden von setup.exe nur geladen, wenn sie sich in der Microsoft Windows Preinstallation Environment (Windows PE 2.0)-Phase der Setupverarbeitung befinden.

  • Wenn ein neuer Computer mit dem Netzwerk verbunden ist, kann die integrierte PXE-Technologie (Preboot Execution Environment) verwendet werden, um das Netzwerkstartprogramm herunterzuladen. Weitere Informationen zum PXE-Start eines Computers zum Installieren von Windows finden Sie unter The Windows Deployment Services Update Step-by-Step Guide.
  • Ein startbares RAMDISK-Image Windows PE 2.0 kann in gespeichert werden. WIM-Format und als Teil des Netzwerkstartprozesses heruntergeladen. Windows PE kann dann direkt von diesem Medium geladen und ausgeführt werden.

Öffnen einer Sitzung mit dem WDS-Server

Der WDS-Client muss eine Sitzung mit einem WDS-Server öffnen.

  • Verwenden Sie die WdsCliCreateSession-Funktion, um eine Sitzung mit einem WDS-Server zu öffnen. Diese Funktion verwendet den Namen oder die IP-Adresse des Servers und empfängt die Adresse des Handles für die WDS-Clientsitzung.
  • Wenn zum Öffnen der Sitzung mit dem Server eine Authentifizierung des WDS-Clients erforderlich ist, sollte die Anwendung beim Aufrufen der WdsCliCreateSession-Funktion die Adresse einer CRED-Struktur der _ WDS-CLI _ mit den Clientanmeldeinformationen angeben. Die Anwendung kann die WdsCliAuthorizeSession-Funktion verwenden, um eine anonyme Sitzung in eine authentifizierte Sitzung zu konvertieren.
  • Wenn die mit der WdsCliCreateSession-Funktion geöffnete Sitzung nicht mehr benötigt wird, sollte die Anwendung die WdsCliClose-Funktion verwenden, um das Handle zu schließen und ressourcen freizugeben, die in der Sitzung enthalten sind.

Aufzählen von Systemabbildern auf dem WDS-Server

Der WDS-Client kann die API verwenden, um die Systemabbilder auf dem WDS-Server zu aufzählen.

Informationen zu Bildern

Der WDS-Client kann die API verwenden, um Informationen zu den Images auf einem WDS-Server zu erhalten. Die folgenden Funktionen erhalten Informationen zum aktuellen Image. Da die Funktionen WdsCliFindFirstImage und WdsCliFindNextImage den aktuellen Imagehandleswert ändern, sollte die Anwendung alle informationen speichern, die sie erhält und in Zukunft benötigt, bevor die Funktionen WdsCliFindFirstImage oder WdsCliFindNextImage erneut aufrufen.

Protokollieren von WDS-Clientereignissen

Die Protokollierungsfunktionalität der WDS-Clientbibliothek ermöglicht das Senden von Installationsfortschrittsereignissen vom Client an den WDS-Server.

  • Verwenden Sie die WdsCliInitializeLog-Funktion, um das Protokoll für die WDS-Clientsitzung zu initialisieren.
  • Verwenden Sie die WdsCliLog-Funktion, um Ereignismeldungen in das WDS-Serverprotokoll zu schreiben.
  • Auf Windows Server 2008 schreibt der WDS-Server Clientereignisse in ein anwendungsspezifisches Ereignisprotokoll, das über eventvwr.exe sowie das Debug-Ablaufverfolgungsprotokoll angezeigt werden kann. Auf Windows Server 2003 mit aktivierter Debugprotokollierung schreibt der WDS-Server Clientereignisse in die Protokolldatei unter %windir% \ tracing \ wdsserver.log. Die WDS-Clientprotokollierung muss auf dem Server aktiviert sein, um diese Ereignisse zu erfassen.

Informationen zur Windows Deployment Services-API

Verwenden der Server-API der Windows-Bereitstellungsdienste