DISM: Globale Optionen für die Befehlszeilensyntax

Artikel
06/19/2023

Globale Optionen werden mit den meisten Wartungs- und Imageoptionen in der Bereitstellungsimagewartung und -verwaltung (DISM) verwendet. Diese Optionen können verwendet werden, um auf die Befehlszeilenhilfe zuzugreifen, Dateispeicherorte anzugeben und die Protokollierung zu steuern.

Grundlegende Syntax für Wartungsbefehle

Nachdem Sie ein Windows-Image bereitgestellt oder angewendet haben, ist es offline als flache Dateistruktur verfügbar, die Sie globale DISM-Optionen, eine Wartungsoption für Ihr Image und den Speicherort des Offlineimages angeben können. Sie können nur eine Wartungsoption pro Befehlszeile verwenden.

Wenn Sie einen ausgeführten Computer warten, verwenden Sie die /Online Option. Wenn Sie ein bereitgestelltes oder angewendetes Image warten, geben Sie /Image:<path_to_image>an. Welche Befehle und Optionen für die Wartung eines Images verfügbar sind, hängt davon ab, welches Windows Betriebssystem Sie warten. Sie hängen auch davon ab, ob das Image offline oder ein ausgeführtes Betriebssystem ist. Alle Befehle funktionieren in einem Offline-Windows-Image. Teilmengen der Befehle sind für die Wartung eines ausgeführten Betriebssystems verfügbar.

Die Basissyntax für DISM-Wartungsbefehle lautet:

DISM.exe {/Image:<path_to_image> | /Online} [dism_global_options] {servicing_option} [<servicing_argument>]

Weitere Informationen zu Wartungsbefehlen finden Sie unter "Deployment Image Servicing and Management" (DISM) Command-Line Optionen.

Grundlegende Syntax für Bildverarbeitungsbefehle

Viele der globalen Optionen stehen auch für Bildbildbefehle zur Verfügung. Die Basissyntax für DISM-Imaging-Befehle lautet:

DISM.exe [dism_global_options] {servicing_option} [<servicing_argument>]

Weitere Informationen zur Verwendung von DISM für die Bildverwaltung, z. B. Anwenden oder Anbringen eines Bilds, finden Sie unter DISM Image Management Command-Line Optionen.

Globale Optionen für Wartungs- und Bilderstellungsbefehle

Syntax für Offlinebilder

Die folgenden globalen DISM-Optionen sind für ein Offlineimage verfügbar.

DISM.exe /image:<path_to_offline_image_directory> [/WinDir:<path_to_%WINDIR>] [/LogPath:<path_to_log_file.log>] [/LogLevel:<n>] [/SysDriveDir:<path_to_bootMgr_file>] [/Quiet] [/NoRestart] [/ScratchDir:<path_to_scratch_directory>] [/English] [/Format:<output_format>]

Syntax für Onlinebilder

Die folgenden globalen DISM-Optionen sind für ein ausgeführtes Betriebssystem verfügbar.

DISM.exe /online [/LogPath:<path_to_log_file>] [/LogLevel:<n>] [/SysDriveDir:<path_to_bootMgr_file>] [/Quiet] [/NoRestart] [/ScratchDir:<path_to_scratch_directory>] [/English] [/Format:<output_format>]

Optionen

In der folgenden Tabelle finden Sie eine Beschreibung, wie jede globale DISM-Option verwendet werden kann. Bei diesen Optionen wird keine Groß-/Kleinschreibung berücksichtigt.

Globale Option	Beschreibung
/Get-Help /?	Zeigt Informationen zu verfügbaren DISM-Befehlszeilenoptionen und -argumenten an. Verwenden Sie die Option "/? oder /Get-Help", ohne eine Bilddatei anzugeben, um Hilfe zu Bildverwaltungsbefehlen wie z. B. /Mount-Image zu erhalten. Beispiel: Dism /? Geben Sie eine Bilddatei mit der Option /Image:<path_to_an_image> an, oder verwenden Sie die Option /Online , um Hilfe zum Wartungsbefehl im Bild zu erhalten, z. B. /Get-Packages. Die Optionen, die für die Wartung eines Bilds verfügbar sind, hängen von der Wartungstechnologie ab, die in Ihrem Bild verfügbar ist. Beispiel: Dism /image:C:\test\offline /? Dism /online /? Sie können zusätzliche Hilfe anzeigen, indem Sie eine Befehlszeilenoption angeben. Beispiel: Dism /image:C:\test\offline /Add-Driver /? Dism /image:C:\test\offline /Add-Package /? Dism /online /Get-Drivers /?
/LogPath:<Pfad zur Protokolldatei.log>	Gibt den vollständigen Pfad und den Dateinamen für die Protokollierung an. Wenn nicht festgelegt, lautet die Standardeinstellung: %WINDIR%\Logs\Dism\dism.log Wichtig In Windows PE ist das Standardverzeichnis der RAMDISK-Speicher, der bis zu 32 MB groß sein kann. Die Protokolldatei wird automatisch archiviert. Die archivierte Protokolldatei wird mit der Dateinamenerweiterung %%amp;quot;.bak%%amp;quot; gespeichert, und eine neue Protokolldatei wird generiert. Bei jeder Archivierung der Protokolldatei wird die BAK-Datei überschrieben. Wenn Sie eine Netzwerkfreigabe verwenden, die nicht Mitglied einer Domäne ist, verwenden Sie den Befehl net use zusammen mit Domänenanmeldeinformationen, um Zugriffsberechtigungen festzulegen, bevor Sie den Protokollpfad für das DISM-Protokoll festlegen. Beispiel: Dism /image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.cab
/LogLevel:<n>	Gibt die maximale Ausgabeebene an, die in den Protokollen angezeigt wird. Die Standardprotokollebene ist 3. Die akzeptierten Werte sind wie folgt: 1 = Nur Fehler 2 = Fehler und Warnungen 3 = Fehler, Warnungen und Information 4 = Alle zuvor aufgeführten Informationen sowie Debugausgabe Beispiel: Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab
/Image:<path_to_offline_image_directory>	Gibt den vollständigen Pfad zum Stammverzeichnis des Offline-Windows-Abbilds, das Sie warten. Wenn das Verzeichnis mit dem Namen Windows kein Unterverzeichnis des Stammverzeichnisses ist, muss /WinDir angegeben werden. Diese Option kann nicht zusammen mit /Online verwendet werden. Beispiel: Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab
/WinDir:<path_to_%WINDIR%>	Wird mit der Option /Image verwendet, um den Pfad zum Windows-Verzeichnis relativ zum Bildpfad anzugeben. Hierbei darf es sich nicht um den vollständigen Pfad zum Windows-Verzeichnis handeln. Der Pfad sollte ein relativer Pfad sein. Ohne Angabe eines Pfads wird standardmäßig das Windows-Verzeichnis im Stamm des Offlineimageverzeichnisses verwendet. Diese Option kann nicht zusammen mit der Option /Online verwendet werden. Beispiel: Dism /image:C:\test\offline /WinDir:WinNT /Add-Package /PackagePath:C:\packages\package.cab
/Online	Gibt die auf dem Betriebssystem vorgenommene Aktion an, die derzeit ausgeführt wird. Diese Option kann nicht mit der Option /Image oder der Option /WinDir verwendet werden. Wenn /Online verwendet wird, wird das Windows-Verzeichnis für das Onlineimage automatisch erkannt. Beispiel: Dism /online /Get-Packages
/SysDriveDir:<path_to_sysdrive_directory>	Verwenden Sie /SysDriveDir, um ein installiertes Windows-Abbild aus einer Windows PE-Umgebung zu warten. Die Option /SysDriveDir gibt den Pfad zum Speicherort der BootMgr-Dateien an. Dies ist nur erforderlich, wenn sich die BootMgr-Dateien nicht auf der Partition befinden, auf der der Befehl ausgeführt wird. Geben Sie beispielsweise an einer Windows PE-Eingabeaufforderung Folgendes ein: Dism /image:C:\Windows /SysDriveDir:C:</strong>
/Quiet	Deaktiviert Informationen und Statusausgabe in der Konsole. Nur Fehlermeldungen werden angezeigt. Wenn Sie im ruhigen Modus ausgeführt werden möchten, muss diese Option jedes Mal festgelegt werden, wenn das Befehlszeilenprogramm ausgeführt wird. Hinweis Verwenden Sie die Option /Still nicht mit /Get-Befehlen . Es werden keine Informationen angezeigt. Beispiel: Dism /image:C:\test\offline /Add-Package /PackagePath:C:\packages\package.cab /quiet
/NoRestart	Unterdrückt den Neustart. Ist kein Neustart erforderlich, hat dieser Befehl keine Auswirkungen. Diese Option verhindert, dass die Anwendung zu einem Neustart auffordert (oder dass sie automatisch neu startet, wenn die Option /Quiet verwendet wird). Beispiel: Dism /online /Add-Package /PackagePath:C:\packages\package.cab /NoRestart /quiet
/ScratchDir:<path_to_scratchdirectory>	Gibt ein temporäres Verzeichnis an, das beim Extrahieren von Dateien zur vorübergehenden Verwendung während der Wartung verwendet wird. Das Verzeichnis muss lokal vorhanden sein. Wenn nichts angegeben wird, wird das Verzeichnis \Windows<em>%Temp% verwendet, wobei der Name des Unterverzeichnisses bei jedem DISM-Lauf einen zufällig generierten hexadezimalen Wert hat. Die Elemente im Scratchverzeichnis werden nach jedem Vorgang gelöscht. Zur Erweiterung eines Pakets für die Installation (CAB- oder MSU-Datei) darf keine Netzwerkfreigabe als Scratchverzeichnis verwendet werden. Bei dem Verzeichnis, das zum temporären Extrahieren von Dateien während der Wartung verwendet wird, muss es sich um ein lokales Verzeichnis handeln. Beispiel: Dism /image:C:\test\offline /ScratchDir:C:\Scratch /Add-Package /PackagePath:C:\packages\package.cab
/English	Zeigt die Befehlszeilenausgabe auf Englisch an. Hinweis Einige Ressourcen können nicht in Englisch angezeigt werden. Diese Option wird nicht unterstützt, wenn Sie den Befehl DISM /? verwenden. Beispiel: Dism /Get-ImageInfo /ImageFile:C:\test\offline\install.wim /index:1 /English
/Format:{Table \| List}	Gibt das Berichtsausgabeformat an. Beispiel: Dism /Image:C:\test\offline /Get-Apps /Format:table