Verwenden der DISM-API
Mit der API "Deployment Image Servicing and Management" (DISM) können Sie benutzerdefinierte Lösungen auf der DISM-Plattform erstellen. Sie können die DISM-API zum Installieren, Deinstallieren, Konfigurieren und Aktualisieren Windows Features, Paketen und Treibern in einem Windows verwenden. DISM kann verwendet werden, um Windows-Images entweder im Windows-Image-Dateiformat (WIM) oder virtuellen Festplattendateien (.vhd, .vhd, .vhdx) zu verwalten und zu verwalten.
Anforderungen
Sie müssen das Windows Assessment and Deployment Kit (Windows ADK) auf Ihrem Entwicklungscomputer installieren, um DISM-API-Anwendungen zu erstellen:
Ihre angepassten Lösungen auf der DISM-Plattform werden mithilfe des DISM SDK entwickelt. Dies wird installiert, wenn windows ADK installiert ist. Weitere Informationen zu unterstützten Betriebssystemen finden Sie in der technischen Referenz für Windows Assessment and Deployment Kit (Windows ADK).
Wenn Sie benutzerdefinierte Lösungen auf der DISM-Plattform ausführen, müssen Sie überprüfen, ob die Windows ADK-Architekturversion mit der Betriebssystemarchitekturversion übereinstimmt. Beispielsweise wird eine angepasste Lösung, die für 32-Bit-PCs entwickelt wurde, auf der 32-Bit-Version von Windows ausgeführt.
Um Ihre angepassten Lösungen auf der DISM-Plattform ordnungsgemäß zu entwickeln und auszuführen, müssen Sie überprüfen, ob Sie die DISM-Binärdateien aus dem Windows ADK verwenden:
Installieren Sie die neueste Version der Windows ADK auf dem PC, die die angepasste Lösung ausführt.
Die Binärdateien für Ihre angepassten Lösungen müssen im gleichen Verzeichnis wie die von der Windows ADK installierten DISM-Binärdateien gespeichert werden. Beispielsweise müssen sich Ihre benutzerdefinierten Lösungen binärdateien in c:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\DISM befinden.
Führen Sie Ihre angepassten Lösungen aus der Bereitstellungs- und Imagingtools-Umgebung aus, sodass die erforderlichen Umgebungsvariablen vor dem Ausführen Ihrer Lösungen eingerichtet werden.
Geben Sie im Startbildschirm die Bereitstellung ein. Klicken Sie mit der rechten Maustaste auf Umgebung für Bereitstellungs- und Imageerstellungstools , und wählen Sie Als Administrator ausführenaus.
Hinweis Wenn Sie nicht aus der Umgebung für Bereitstellungs- und Imagingtools ausgeführt werden, müssen Sie überprüfen, ob die PATH-Umgebungsvariable den Speicherort der DISM-Binärdateien aus dem Windows ADK verwendet.
Sie benötigen einen unterstützten Windows-Imagedateityp, WIM, VHD oder VHDX oder eine Onlineinstallation von Windows, um die DISMAPI für die Wartung und Verwaltung zu verwenden. Einige Vorgänge sind auf Onlineimages nicht gültig. Weitere Informationen finden Sie unter DISM API Reference.
Unterstützte Zielbilder
Die Windows-Imagedatei, die Sie auf Ihrem Hostcomputer warten, kann eine WIM-Datei, eine VHD- oder VHDX-Datei oder eine Onlineinstallation von Windows sein. Darüber hinaus wird die architekturübergreifende Wartung unterstützt. Sie können ein x64-Bild aus einem x86-System oder einem x64-System verwenden. Sie können ein x86-Bild aus einem x64-System oder einem x86-System serviceen.
Alle DISMAPI-Funktionen können auf Windows 8 und Windows Server 2012 Zielbildern ausgeführt werden. Informationen dazu, ob eine Funktion auf anderen Zielbildern ausgeführt werden kann, finden Sie im Abschnitt "Anforderungen" des Funktionsreferenzthemas in der DISM-API-Referenz.
Bewährte Methoden
Speicherverwaltung. Bestimmte DISM-API-Funktionen geben Strukturen oder Arrays von Strukturen zurück. Diese Strukturen werden dem Benutzer als Zeiger auf ein Objekt auf dem Heap zurückgegeben. Der Heap-Speicher wird von der DISM-API zugewiesen. Der Client muss die DismDelete-Funktion aufrufen, um sicherzustellen, dass dieser Speicher freigegeben wird.
Erstellen einer VHD mit dem DiskPart-Tool. Wenn möglich, sollten Sie die DISM-API zum Bereitstellen und Aufheben der Bereitstellung von Images verwenden, die Sie im DISM-Framework nutzen möchten. Mit einem anderen Tool, z. B. dem DiskPart-Tool, können sie unerwartete Effekte haben, um das Bild zu mounten und zu aufheben.
Dateipfade. Alle von DISM-API-Funktionen akzeptierten Pfade können relativ oder absolut sein. Als bewährte Methode beschränken Sie die Länge der Dateipfade. Dateipfade, die zu lang sind oder die maximale Längenbeschränkung für Windows überschreiten, führen zu Fehlern in DISM.
Übereinstimmende Anrufe zum Öffnen und Schließen von Sitzungen. Veröffentlichen Sie immer eine DISM-Sitzung mithilfe der DismCloseSession-Funktion , bevor Sie die DismShutdown-Funktion aufrufen. Sie können das Bild auch nach dem Schließen der Sitzung und vor dem Aufrufen der DismShutdown-Funktion mit der Funktion DismUnmountImage aufheben.
Weitere DISM-Tools
Weitere Informationen zur DISM-Plattform und zu anderen Möglichkeiten zum Zugriff auf die Wartungs- und Verwaltungsfunktionen finden Sie im technischen Referenz zur TECHNISCHEn Referenz für DISM im Windows Assessment and Deployment Kit (Windows ADK). Sie können auch das DISM.exe Tool in Windows ADK verwenden, um ein Bild als WIM-Datei zu erfassen.
Verwandte Themen
Erstellen einer DISM-Anwendung