Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In Umgebungen, in denen keine WDS-Standardlösung (Windows Deployment Services) zum Installieren von Windows verwendet werden kann, ermöglicht die API des WDS-Clients Entwicklern das Schreiben benutzerdefinierter Bereitstellungsanwendungen. Anwendungen können diese API verwenden, um mit dem WDS-Server zu kommunizieren, um Informationen zu Systemimages abzurufen, die vom Server verfügbar sind. Benutzerdefinierte WDS-Clientanwendungen sollten den folgenden Richtlinien entsprechen.
Installieren der WDS-Rolle auf dem Server
- Windows-Bereitstellungsdienste (WINDOWS Deployment Services, WDS) sind 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 unter Windows Server 2003 mit Service Pack 1 (SP1) aktualisieren. Sie können die WDS-Serverrolle mit dem Windows Automated Installation Kit (WAIK) installieren.
Starten von Windows PE 2.0
Windows PE 2.0 muss gestartet werden, sofern noch nicht gestartet. Der WDS-Client und die unterstützenden DLLs werden nur von setup.exe geladen, wenn sie sich in der Setupverarbeitungsphase der Microsoft Windows-Vorinstallationsumgebung (Windows PE 2.0) 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-Starten eines Computers zum Installieren von Windows finden Sie unter Schritt-für-Schritt-Anleitung zum Update der Windows-Bereitstellungsdienste.
- Ein startbares RAMDISK-Image von Windows PE 2.0 kann in gespeichert werden. WIM-Format und heruntergeladen als Teil des Netzwerkstartvorgangs. 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 akzeptiert 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 WDS_CLI_CRED Struktur angeben, die die Clientanmeldeinformationen enthält. 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 von der Sitzung gespeichert sind.
Auflisten von Systemimages auf dem WDS-Server
Der WDS-Client kann die API verwenden, um die Systemimages auf dem WDS-Server aufzulisten.
- Verwenden Sie die WdsCliFindFirstImage-Funktion , um ein Handle für das erste Bild abzurufen und die Enumeration von Bildern auf dem WDS-Server zu initialisieren.
- Verwenden Sie die WdsCliFindNextImage-Funktion , um die Enumeration zu erhöhen, die von der WdsCliFindFirstImage-Funktion gestartet wurde. Die WdsCliFindNextImage-Funktion ruft das Handle für das nächste Bild ab.
- Verwenden Sie die WdsCliGetImageIndex-Funktion , um den Bildindex für das aktuelle Bild abzurufen. Dieser Wert ist nur gültig, bis die Funktionen WdsCliFindNextImage oder WdsCliClose erneut verwendet werden.
- Verwenden Sie die WdsCliGetEnumerationFlags-Funktion , um Informationsflags zur Bildfilterung abzurufen.
Abrufen von Informationen zu Bildern
Der WDS-Client kann die API verwenden, um Informationen zu den Bildern auf einem WDS-Server abzurufen. Die folgenden Funktionen rufen Informationen zum aktuellen Bild ab. Da die Funktionen WdsCliFindFirstImage und WdsCliFindNextImage den aktuellen Bildhandlewert ändern, sollte die Anwendung alle informationen speichern, die sie erhält und in Zukunft benötigt, bevor die Funktionen WdsCliFindFirstImage oder WdsCliFindNextImage erneut aufgerufen werden.
- Verwenden Sie die WdsCliGetImageArchitecture-Funktion , um die Prozessorarchitektur des aktuellen Bilds abzurufen.
- Verwenden Sie die WdsCliGetImagePath-Funktion , um den relativen Pfad zur Bilddatei abzurufen, die das aktuelle Bild enthält.
- Verwenden Sie die WdsCliGetImageSize-Funktion , um die Bildgröße abzurufen.
- Verwenden Sie die WdsCliGetImageVersion-Funktion , um die Imageversion abzurufen.
- Verwenden Sie die WdsCliGetImageLanguage-Funktion , um die Standardsprache des aktuellen Bilds abzurufen.
- Verwenden Sie die WdsCliGetImageLanguages-Funktion , um ein Array von Sprachen abzurufen, das vom aktuellen Bild unterstützt wird.
- Verwenden Sie wdsCliGetImageLastModifiedTime gibt den Zeitpunkt der letzten Änderung für das aktuelle Bild zurück.
- Verwenden Sie die WdsCliGetImageName-Funktion , um den Namen des aktuellen Bilds abzurufen.
- Verwenden Sie die WdsCliGetImageDescription-Funktion , um die Beschreibung des aktuellen Bilds abzurufen.
- Verwenden Sie die WdsCliGetImageGroup-Funktion , um den Namen der Bildgruppe für das aktuelle Bild abzurufen.
- Verwenden Sie die WdsCliGetImageHalName-Funktion , um den Hal-Namen (Hardware Abstraction Layer) für das aktuelle Image abzurufen.
Protokollieren von WDS-Clientereignissen
Die Protokollierungsfunktion der WDS-Clientbibliothek ermöglicht das Senden von Installationsstatusereignissen 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.
- Unter Windows Server 2008 schreibt der WDS-Server Clientereignisse in ein anwendungsspezifisches Ereignisprotokoll, das über eventvwr.exe sowie das Debugablaufverfolgungsprotokoll angezeigt werden kann. Unter 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.
Zugehörige Themen