DISM Operating System Package (.cab oder .msu) Servicing Command-Line Options

Verwenden Sie DISM mit Windows .cab oder Windows MSU-Dateien (Update Stand-alone Installer), um Updates, Service Packs und Sprachpakete zu installieren oder zu entfernen sowie Windows Features zu aktivieren oder zu deaktivieren. Features sind optionale Komponenten für das Kernbetriebssystem.

Syntax

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

Die folgenden Optionen für die Betriebssystempaketwartung sind für ein Offlineimage verfügbar:

DISM.exe /Image:<path_to_image_directory> [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

Die folgenden Betriebssystem-Paketwartungsoptionen sind für ein ausgeführtes Betriebssystem verfügbar:

DISM.exe /Online [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

/Get-Help /?

Wenn sie unmittelbar nach einer Befehlszeilenoption für die Paketwartung verwendet wird, werden Informationen über die Option und die Argumente angezeigt.

Zusätzliche Themen können verfügbar sein, wenn ein Image angegeben wird.

Syntax:

Dism /Get-Help 

Beispiele:

Dism /Image:C:\test\offline /Add-Package /?
Dism /Online /Get-Packages /?

/Get-Packages

Zeigt grundlegende Informationen zu allen Paketen im Bild an. Verwenden Sie das /Format:Table Argument oder , um die Ausgabe als Tabelle oder Liste /Format:List anzuzeigen.

Syntax:

Dism /Get-Packages [/Format:{Table | List}]

Beispiele:

Dism /Image:C:\test\offline /Get-Packages
Dism /Image:C:\test\offline /Get-Packages /Format:Table
Dism /Online /Get-Packages

/Get-PackageInfo

Zeigt ausführliche Informationen zu einem Paket an, das als .cab Datei bereitgestellt wird. Es können nur .cab Dateien angegeben werden. Sie können diesen Befehl nicht verwenden, um Paketinformationen für MSU-Dateien abzurufen. /PackagePath:<path_to_package> kann auf eine .cab Datei oder einen Ordner verweisen.

Sie können die /Get-Packages Option verwenden, um den Namen des Pakets im Image zu suchen, oder Sie können den Pfad zur .cab Datei angeben. Der Pfad zur .cab Datei sollte auf die ursprüngliche Quelle des Pakets verweisen, nicht auf den Ort, an dem die Datei im Offlineimage installiert ist.

Syntax:

Dism /Get-PackageInfo {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}

Beispiele:

Dism /Image:C:\test\offline /Get-PackageInfo /PackagePath:C:\packages\package.cab
Dism /Image:C:\test\offline /Get-PackageInfo /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Add-Package

Installiert ein angegebenes .cab- oder MSU-Paket im Image. Ein MSU-Paket wird nur unterstützt, wenn das Zielimage offline ist, entweder eingebunden oder angewendet wird.

Mehrere Pakete können über eine Befehlszeile hinzugefügt werden. Die Anwendbarkeit der einzelnen Pakete wird überprüft. Wenn das Paket nicht auf das angegebene Image angewendet werden kann, erhalten Sie eine Fehlermeldung. Verwenden Sie das Argument /IgnoreCheck, wenn der Befehl verarbeitet werden soll, ohne die Anwendbarkeit der einzelnen Pakete zu überprüfen.

Syntax:

Dism /Add-Package /PackagePath:<path_to_cabfile> [/IgnoreCheck] [/PreventPending]
  • /PackagePath kann auf:

    • Eine einzelne .cab- oder MSU-Datei.
    • Ein Ordner, der eine einzelne erweiterte .cab-Datei enthält.
    • Ein Ordner, der eine einzelne MSU-Datei enthält.
    • Ein Ordner, der mehrere .cab- oder MSU-Dateien enthält.
  • Wenn auf einen Ordner verweist, der /PackagePath eine .cab- oder MSU-Dateien im Stammverzeichnis enthält, werden alle Unterordner auch rekursiv auf .cab- und MSU-Dateien überprüft.

  • Verwenden Sie die /PreventPending Option , um die Installation des Pakets zu überspringen, wenn das Paket oder Windows Image über ausstehende Onlineaktionen verfügt.

Hinweis

/Add-Package führt keine vollständige Überprüfung der Anwendbarkeit und Abhängigkeiten eines Pakets aus. Wenn Sie ein Paket mit Abhängigkeiten hinzufügen, stellen Sie sicher, dass alle Abhängigkeiten installiert sind, wenn Sie das Paket hinzufügen.

Beispiele:

Dism /Image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.msu
Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab /IgnoreCheck
Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\test\packages\package.cab /PreventPending

/Remove-Package

Entfernt ein angegebenes .cab-Dateipaket aus dem Image. Es können nur .cab Dateien angegeben werden. Sie können diesen Befehl nicht verwenden, um MSU-Dateien zu entfernen.

Hinweis

Wenn Sie mit diesem Befehl ein Paket aus einem Offlineimage entfernen, wird die Imagegröße nicht reduziert.

Syntax:

/Remove-Package {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}
  • Verwenden Sie /PackagePath , um auf die ursprüngliche Quelle des Pakets zu verweisen, den Pfad zur CAB-Datei anzugeben, oder , um das Paket anhand des Namens anzugeben, wie es in der Abbildung aufgeführt ist. Verwenden Sie die /Get-Packages Option , um den Namen des Pakets im Image zu suchen.

Beispiele:

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0
Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0 /PackageName:Microsoft-Windows-MediaPlayer-Package~31bf3856ad364e35~x86~~6.1.6801.0
Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab

/Get-Features

Zeigt grundlegende Informationen zu allen Features (Betriebssystemkomponenten, die optionale Windows Grundlegende Features enthalten) in einem Paket an.

Syntax:

/Get-Features {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>} [/Format:{Table | List}]
  • /Get-Features sucht den Namen der Pakete im Image oder in der ursprünglichen Quelle des Pakets. Wenn Sie keinen Paketnamen oder Pfad angeben, werden alle Features im Image aufgelistet.
  • /PackageName ist ein Paket in einem Image. Sie können /DISM Get-Packages verwenden, um die Paketnamen in einem Image anzuzeigen.
  • /PackagePath kann auf eine .cab Datei oder einen Ordner verweisen.

Verwenden Sie das /Format:Table Argument oder , um die Ausgabe als Tabelle oder Liste /Format:List anzuzeigen.

Beispiele:

Dism /Image:C:\test\offline /Get-Features
Dism /Image:C:\test\offline /Get-Features /Format:List
Dism /Image:C:\test\offline /Get-Features /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0
Dism /Image:C:\test\offline /Get-Features /PackagePath:C:\packages\package1.cab

/Get-FeatureInfo

Zeigt ausführliche Informationen zu einem Feature an. Hierzu muss /FeatureName verwendet werden. Sie können die /Get-Features Option verwenden, um den Namen des Features im Bild zu suchen.

Syntax:

/Get-FeatureInfo /FeatureName:<name_in_image> [{/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}]

/PackageName und /PackagePath sind optional und können verwendet werden, um ein bestimmtes Feature in einem Paket zu finden.

Beispiele:

Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts
Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts /PackagePath:C:\packages\package.cab

/Enable-Feature

Aktiviert oder aktualisiert das angegebene Feature im Image. Sie müssen die /FeatureName Option verwenden. Verwenden Sie die /Get-Features Option , um den Namen des Features in der Abbildung zu suchen.

Syntax:

/Enable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Source: <source>] [/LimitAccess] [/All]

Sie können die /FeatureName Option mehrmals in einer Befehlszeile für Features angeben, die dasselbe übergeordnete Paket gemeinsam nutzen.

Sie müssen den Paketnamen nicht mithilfe der Option angeben, wenn es sich bei dem Paket um /PackageName ein Windows Foundation Package handelt. Verwenden Sie andernfalls /PackageName , um das übergeordnete Paket des Features anzugeben.

Sie können ein Feature wiederherstellen und aktivieren, das zuvor aus dem Image entfernt wurde. Verwenden Sie das /Source -Argument, um den Speicherort der Dateien anzugeben, die zum Wiederherstellen des Features erforderlich sind. Die Quelle der Dateien kann durch die Windows Ordner in einem eingebundenen Image, z. c:\test\mount\Windows B. . Sie können auch einen Windows ordner nebeneinander als Quelle der Dateien verwenden, z. z:\sources\SxS B. .

Wenn Sie mehrere /Source-Argumente angeben, werden die Dateien von dem ersten Speicherort gesammelt, an dem sie gefunden werden. Die übrigen Speicherorte werden ignoriert. Wenn Sie keine /Source für ein Feature angeben, das entfernt wurde, wird der Standardspeicherort in der Registrierung verwendet, oder für Onlineimages wird Windows Update (WU) verwendet.

  • Verwenden Sie /LimitAccess , um zu verhindern, dass DISM sich bei Onlineimages mit WU in Verbindung setzt.
  • Verwenden Sie /All , um alle übergeordneten Features des angegebenen Features zu aktivieren.

Beispiele:

Dism /Online /Enable-Feature /FeatureName:Hearts /All
Dism /Online /Enable-Feature /FeatureName:Calc /Source:c:\test\mount\Windows /LimitAccess
Dism /Image:C:\test\offline /Enable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Disable-Feature

Deaktiviert das angegebene Feature im Bild. Sie müssen die Option /FeatureName verwenden. Verwenden Sie die /Get-Features Option , um den Namen des Features in der Abbildung zu suchen.

Syntax:

/Disable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Remove]

Sie können /FeatureName mehrere Male in einer Befehlszeile für Features im gleichen übergeordneten Paket angeben.

Sie müssen den Paketnamen nicht mithilfe der Option /PackageName angeben, wenn es sich bei dem Paket um ein Windows Foundation Package handelt. Verwenden Sie andernfalls /PackageName , um das übergeordnete Paket des Features anzugeben.

Verwenden Sie /Remove , um ein Feature zu entfernen, ohne das Manifest des Features aus dem Image zu entfernen. Das Feature wird als "Entfernt" aufgeführt, wenn Sie zum Anzeigen von Featuredetails verwenden /Get-FeatureInfo und mithilfe von /Enable-Feature mit der Option /Source wiederhergestellt und aktiviert werden können.

Beispiele:

*Dism /Online /Disable-Feature /FeatureName:Hearts
Dism /Image:C:\test\offline /Disable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Cleanup-Image

Führt Bereinigungs- oder Wiederherstellungsvorgänge für das Image aus. /AnalyzeComponentStoreund /ResetBase können mit Windows 10, Windows 8.1 und Windows PE-Images über 5.0 verwendet werden. Ab Windows 10 Version 1607 können Sie mit angeben. /Defer Sie sollten jedoch /ResetBase nur als Option in der Factory verwenden, /Defer für die mehr als DISM /Resetbase 30 Minuten benötigt werden.

Tipp

Um zu ermitteln, wann die Option /ResetBase zuletzt ausgeführt wurde, überprüfen Sie den LastResetBase_UTC Registrierungseintrag unter dem HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing Registrierungspfad.

Syntax:

/Cleanup-Image {/RevertPendingActions | /SPSuperseded [/HideSP] | /StartComponentCleanup [/ResetBase [/Defer]] | /AnalyzeComponentStore | /CheckHealth | /ScanHealth | /RestoreHealth [/Source: <filepath>] [/LimitAccess]}
Parameter BESCHREIBUNG
/RevertPendingActions Bei einem Startfehler können Sie mithilfe der Option /RevertPendingActions versuchen, das System wiederherzustellen. Durch den Vorgang werden alle ausstehenden Aktionen aus den vorherigen Wartungsvorgängen zurückgesetzt, da diese Aktionen möglicherweise die Ursache für den Startfehler sind. Die Option /RevertPendingActions wird auf einem laufenden Betriebssystem oder einem Windows PE- oder Windows Recovery Environment-Image (Windows RE) nicht unterstützt. Wichtig: Sie sollten die Option /RevertPendingActions nur in einem Systemwiederherstellungsszenario für ein Windows Image verwenden, das nicht gestartet wurde.
SPSuperseded Entfernt alle Sicherungsdateien, die während der Installation eines Service Packs erstellt wurden. Verwenden Sie /HideSP, um zu verhindern, dass das Service Pack in der Systemsteuerung Installierte Updates aufgeführt wird. Das Service Pack kann nach Abschluss des Vorgangs /SPSuperseded nicht deinstalliert werden.
/StartComponentCleanup Bereinigt die abgelösten Komponenten und reduziert die Größe des Komponentenspeichers. Verwenden Sie /ResetBase, um die Basis der abgelösten Komponenten zurückzusetzen, wodurch die Größe des Komponentenspeichers weiter reduziert werden kann. Installierte Windows Updates können nach dem Ausführen von /StartComponentCleanup mit der Option /ResetBase nicht deinstalliert werden. Verwenden Sie /Defer mit /ResetBase, um Bereinigungsvorgänge mit langer Laufzeit auf die nächste automatische Wartung zurückzusetzen.
/AnalyzeComponentStore Erstellt einen Bericht des Komponentenspeichers. Weitere Informationen zum Bericht und zur Verwendung der im Bericht bereitgestellten Informationen finden Sie unter Bestimmen der tatsächlichen Größe des WinSxS-Ordners.
/CheckHealth Überprüft, ob das Image durch einen fehlerhaften Prozess als beschädigt gekennzeichnet wurde und ob die Beschädigung repariert werden kann.
/ScanHealth Überprüft das Bild auf Beschädigungen des Komponentenspeichers. Dieser Vorgang dauert einige Minuten.
/RestoreHealth Überprüft das Image auf Beschädigungen des Komponentenspeichers und führt dann automatisch Reparaturvorgänge aus. Dieser Vorgang dauert einige Minuten.
/Source Wird mit /RestoreHealth verwendet, um den Speicherort bekannter guter Versionen von Dateien anzugeben, die für die Reparatur verwendet werden können, z. B. einen Pfad zum Windows Verzeichnis eines eingebundenen Images.
/LimitAccess Verhindert, dass DISM Windows Update für die Reparatur von Onlineimages kontaktiert.

Beispiele:

Dism /Image:C:\test\offline /Cleanup-Image /RevertPendingActions
Dism /Image:C:\test\offline /Cleanup-Image /SPSuperseded /HideSP
Dism /Online /Cleanup-Image /ScanHealth
Dism /Online /Cleanup-Image /RestoreHealth /Source:c:\test\mount\windows /LimitAccess

Weitere Informationen finden Sie unter Reparieren eines Windows Image.

Einschränkungen

  • Wenn Sie ein Paket in einem Offlineimage installieren, lautet der Paketstatus aufgrund ausstehender Onlineaktionen "Installation ausstehend". Anders ausgedrückt: Das Paket wird installiert, wenn das Image gestartet und die Onlineaktionen verarbeitet werden. Wenn nachfolgende Aktionen angefordert werden, können sie erst verarbeitet werden, nachdem die vorherige ausstehende Onlineaktion abgeschlossen wurde. Sie können die /PreventPending Option verwenden, wenn Sie ein Paket mit /AddPackage hinzufügen, um die Installation eines Pakets zu überspringen, wenn Onlineaktionen ausstehen.
  • Für einige Pakete müssen zuerst andere Pakete installiert werden. Sie sollten nicht davon ausgehen, dass Abhängigkeiten erfüllt werden. Wenn für ein Paket Abhängigkeitsanforderungen erforderlich sind, verwenden Sie eine Antwortdatei, um die erforderlichen Pakete zu installieren. Durch Übergeben einer Antwortdatei an DISM können mehrere Pakete in der richtigen Reihenfolge installiert werden. Weitere Informationen finden Sie unter Hinzufügen oder Entfernen von Paketen offline mit dism.
  • Pakete werden in der Reihenfolge installiert, in der Sie in der Befehlszeile aufgelistet sind.
  • Bei Verwendung von DISM zum Auflisten der optionalen Komponenten in einem Windows PE-Image werden die optionalen Komponenten immer als ausstehend aufgeführt, auch wenn der Wartungsvorgang erfolgreich war. Dies ist entwurfshalber und erfordert keine zusätzliche Aktion.

Was ist DISM?

Befehlszeilenoptionen für die DSM-Imageverwaltung

Befehlszeilenoptionen für die Abbildverwaltung für die Bereitstellung (DISM)