Options de Command-Line de maintenance du package de système d’exploitation DISM (.cab ou. msu)

utilisez DISM avec Windows armoire (.cab) ou Windows Update fichiers du programme d’installation autonome (. msu) pour installer ou supprimer des mises à jour, des service packs, des modules linguistiques et pour activer ou désactiver les fonctionnalités de Windows. Les fonctionnalités sont des composants facultatifs pour le système d’exploitation principal.

Syntaxe

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

Les options de maintenance de packages de système d’exploitation suivantes sont disponibles pour une image hors connexion :

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]

Les options de maintenance de packages de système d’exploitation suivantes sont disponibles pour un système d’exploitation en cours d’exécution :

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

/Get-Help /?

En cas d’utilisation immédiate après une option de ligne de commande de maintenance de packages, des informations sur l’option et les arguments s’affichent.

Des rubriques supplémentaires peuvent devenir disponibles lorsqu’une image est spécifiée.

Syntaxe :

Dism /Get-Help 

Exemples :

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

/Get-Packages

Affiche des informations de base sur tous les packages de l’image. Utilisez l' /Format:Table /Format:List argument ou pour afficher la sortie sous la forme d’une table ou d’une liste.

Syntaxe :

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

Exemples :

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

/Get-PackageInfo

Affiche des informations détaillées sur un package fourni sous la forme d’un fichier de .cab. Seuls les fichiers .cab peuvent être spécifiés. Vous ne pouvez pas utiliser cette commande pour obtenir des informations de package pour les fichiers. msu. /PackagePath:<path_to_package> peut pointer vers un fichier .cab ou un dossier.

Vous pouvez utiliser l' /Get-Packages option pour rechercher le nom du package dans l’image, ou vous pouvez spécifier le chemin d’accès au fichier .cab. Le chemin d’accès au fichier .cab doit pointer vers la source d’origine du package, et non vers l’emplacement d’installation du fichier sur l’image hors connexion.

Syntaxe :

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

Exemples :

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

Installe un .cab ou un package. msu spécifié dans l’image. Un package. msu est pris en charge uniquement lorsque l’image cible est hors connexion, qu’elle soit montée ou appliquée.

Vous pouvez ajouter plusieurs packages sur une seule ligne de commande. L’applicabilité de chaque package est vérifiée. Si le package ne peut pas être appliqué à l’image spécifiée, vous recevrez un message d’erreur. Utilisez l’argument/IgnoreCheck si vous souhaitez que la commande soit traité sans vérifier l’applicabilité de chaque package.

Syntaxe :

Dism /Add-Package /PackagePath:<path_to_cabfile> [/IgnoreCheck] [/PreventPending]
  • /PackagePath peut pointer vers :

    • Un .cab unique ou un fichier. msu.
    • Dossier qui contient un fichier de .cab développé unique.
    • Dossier qui contient un fichier. msu unique.
    • Dossier qui contient plusieurs fichiers .cab ou. msu.
  • Si /PackagePath pointe vers un dossier qui contient un .cab ou des fichiers. msu à sa racine, tous les sous-dossiers sont également recherchés de manière récursive pour les .cab et les fichiers. msu.

  • utilisez l' /PreventPending option pour ignorer l’installation du package si le package ou l’image de Windows a des actions en ligne en attente.

Notes

/Add-Package n’exécute pas une vérification complète de l’applicabilité et des dépendances d’un package. Si vous ajoutez un package avec des dépendances, assurez-vous que toutes les dépendances sont installées lorsque vous ajoutez le package.

Exemples :

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

Supprime un package de fichiers .cab spécifié de l’image. Seuls les fichiers .cab peuvent être spécifiés. Vous ne pouvez pas utiliser cette commande pour supprimer des fichiers. msu.

Notes

L’utilisation de cette commande pour supprimer un package d’une image hors connexion ne réduit pas la taille de l’image.

Syntaxe :

/Remove-Package {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}
  • Utilisez /PackagePath pour pointer vers la source d’origine du package, spécifiez le chemin d’accès au fichier CAB ou spécifiez le package par son nom tel qu’il est listé dans l’image. Utilisez l' /Get-Packages option pour rechercher le nom du package dans l’image.

Exemples :

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

affiche des informations de base sur toutes les fonctionnalités (composants du système d’exploitation qui incluent des fonctionnalités Windows foundation facultatives) dans un package.

Syntaxe :

/Get-Features {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>} [/Format:{Table | List}]
  • /Get-Features recherche le nom des packages dans l’image ou dans la source d’origine du package. Si vous ne spécifiez pas de chemin d’accès ou de nom de package, toutes les fonctionnalités de l’image seront listées.
  • /PackageName est un package dans une image. Vous pouvez utiliser /DISM Get-Packages pour afficher les noms de packages dans une image.
  • /PackagePath peut pointer vers un fichier .cab ou un dossier.

Utilisez l' /Format:Table /Format:List argument ou pour afficher la sortie sous la forme d’une table ou d’une liste.

Exemples :

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

Affiche des informations détaillées sur une fonctionnalité. Vous devez utiliser /FeatureName. Vous pouvez utiliser l' /Get-Features option pour rechercher le nom de la fonctionnalité dans l’image.

Syntaxe :

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

/PackageName et /PackagePath sont facultatifs et peuvent être utilisés pour rechercher une fonctionnalité spécifique dans un package.

Exemples :

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

Active ou met à jour la fonctionnalité spécifiée dans l’image. Vous devez utiliser l' /FeatureName option. Utilisez l' /Get-Features option pour rechercher le nom de la fonctionnalité dans l’image.

Syntaxe :

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

Vous pouvez spécifier l' /FeatureName option plusieurs fois dans une ligne de commande pour les fonctionnalités qui partagent le même package parent.

vous n’êtes pas obligé de spécifier le nom du package à l’aide de l' /PackageName option si le package est un package Windows Foundation. Sinon, utilisez /PackageName pour spécifier le package parent de la fonctionnalité.

Vous pouvez restaurer et activer une fonctionnalité qui a déjà été supprimée de l’image. Utilisez l' /Source argument pour spécifier l’emplacement des fichiers nécessaires pour restaurer la fonctionnalité. la source des fichiers peut se faire par le dossier Windows dans une image montée, par exemple c:\test\mount\Windows . vous pouvez également utiliser un dossier côte à côte Windows comme source des fichiers, par exemple z:\sources\SxS .

Si vous spécifiez plusieurs /Source arguments, les fichiers sont collectés à partir du premier emplacement où ils sont trouvés et les autres emplacements sont ignorés. si vous ne spécifiez pas de/source pour une fonctionnalité qui a été supprimée, l’emplacement par défaut dans le registre est utilisé ou, pour les images en ligne, Windows Update (WU) est utilisé.

  • Utilisez /LimitAccess pour empêcher DISM de contacter Wu pour les images en ligne.
  • Utilisez /All pour activer toutes les fonctionnalités parentes de la fonctionnalité spécifiée.

Exemples :

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

Désactive la fonctionnalité spécifiée dans l’image. Vous devez utiliser l’option/FeatureName. Utilisez l' /Get-Features option pour rechercher le nom de la fonctionnalité dans l’image.

Syntaxe :

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

Vous pouvez spécifier /FeatureName plusieurs fois dans une ligne de commande pour les fonctionnalités dans le même package parent.

vous n’avez pas besoin de spécifier le nom du package à l’aide de l’option/packagename si le package est un package Windows Foundation. Sinon, utilisez /PackageName pour spécifier le package parent de la fonctionnalité.

Utilisez /Remove pour supprimer une fonctionnalité sans supprimer le manifeste de la fonctionnalité de l’image. La fonctionnalité est indiquée comme « supprimée » lorsque vous utilisez /Get-FeatureInfo pour afficher les détails de la fonctionnalité et peut être restaurée et activée à l’aide de/Enable-Feature avec l’option/source.

Exemples :

*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

Effectue des opérations de nettoyage ou de récupération sur l’image. /AnalyzeComponentStoreet /ResetBase peuvent être utilisés avec Windows 10, Windows 8.1 et Windows les images PE au-dessus de 5,0. à partir de Windows 10, la version 1607, vous pouvez spécifier /Defer avec /ResetBase , mais vous devez utiliser uniquement /Defer en tant qu’option dans la fabrique où DISM /Resetbase nécessite plus de 30 minutes.

Conseil

Pour déterminer à quel moment l’option/ResetBase a été exécutée pour la dernière fois, vérifiez l’entrée de Registre LastResetBase_UTC sous le HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing chemin d’accès au registre.

Syntaxe :

/Cleanup-Image {/RevertPendingActions | /SPSuperseded [/HideSP] | /StartComponentCleanup [/ResetBase [/Defer]] | /AnalyzeComponentStore | /CheckHealth | /ScanHealth | /RestoreHealth [/Source: <filepath>] [/LimitAccess]}
Paramètre Description
/RevertPendingActions Si vous rencontrez un échec de démarrage, vous pouvez utiliser l’option/RevertPendingActions pour tenter de récupérer le système. L’opération restaure toutes les actions en attente à partir des opérations de maintenance précédentes, car ces actions peuvent être à l’origine de l’échec de démarrage. l’option/RevertPendingActions n’est pas prise en charge sur un système d’exploitation en cours d’exécution ou une image Windows PE ou Windows environnement de récupération (Windows RE). Important : vous devez utiliser l’option/RevertPendingActions uniquement dans un scénario de récupération système sur une image Windows qui n’a pas démarré.
Remplacé Supprime tous les fichiers de sauvegarde créés lors de l’installation d’un Service Pack. Utilisez/HideSP pour empêcher la liste des Service Pack dans le panneau de configuration des mises à jour installées. La Service Pack ne peut pas être désinstallée une fois l’opération/SPSuperseded terminée.
/StartComponentCleanup Nettoie les composants remplacés et réduit la taille du magasin de composants. Utilisez/ResetBase pour réinitialiser la base des composants remplacés, ce qui peut réduire encore davantage la taille du magasin de composants. les mises à jour Windows installées ne peuvent pas être désinstallées après l’exécution de/StartComponentCleanup avec l’option/ResetBase. Utilisez/defer avec/ResetBase pour reporter les opérations de nettoyage de longue durée à la maintenance automatique suivante.
/AnalyzeComponentStore Crée un rapport du magasin de composants. Pour plus d’informations sur le rapport et sur l’utilisation des informations fournies dans le rapport, consultez déterminer la taille réelle du dossier WinSxS.
/CheckHealth Vérifie si l’image a été marquée comme endommagée par un processus qui a échoué et si l’altération peut être réparée.
/ScanHealth Analyse l’image en cas d’endommagement du magasin de composants. Cette opération peut prendre plusieurs minutes.
/RestoreHealth Analyse l’image en cas d’endommagement du magasin de composants, puis effectue automatiquement des opérations de réparation. Cette opération peut prendre plusieurs minutes.
/Source utilisé avec/RestoreHealth pour spécifier l’emplacement des versions appropriées connues des fichiers qui peuvent être utilisés pour la réparation, comme un chemin d’accès au répertoire Windows d’une image montée.
/LimitAccess empêche DISM de contacter Windows Update pour la réparation des images en ligne.

Exemples :

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

pour plus d’informations, consultez réparer une Image Windows.

Limites

  • Lorsque vous installez un package dans une image hors connexion, l’état du package est « installation en attente » en raison d’actions en ligne en attente. En d’autres termes, le package est installé lorsque l’image est démarrée et les actions en ligne sont traitées. Si des actions suivantes sont demandées, elles ne peuvent pas être traitées tant que l’action en ligne précédente en attente n’est pas terminée. Vous pouvez utiliser l' /PreventPending option lorsque vous ajoutez un package avec /AddPackage pour ignorer l’installation d’un package lorsqu’il y a des actions en ligne en attente.
  • Certains packages nécessitent d’abord l’installation d’autres packages. Vous ne devez pas supposer que les dépendances seront respectées. Si un package a des exigences de dépendance, utilisez un fichier de réponses pour installer les packages nécessaires. En passant un fichier de réponses à DISM, plusieurs packages peuvent être installés dans le bon ordre. Pour plus d’informations, consultez Ajouter ou supprimer des packages hors connexion à l’aide de DISM.
  • Les packages sont installés dans l’ordre dans lequel ils sont répertoriés dans la ligne de commande.
  • quand vous utilisez DISM pour répertorier les composants facultatifs dans une image Windows PE, les composants facultatifs sont toujours répertoriés en attente, même lorsque l’opération de maintenance a réussi. Cela est dû à la conception et ne nécessite aucune action supplémentaire.

Qu’est-ce que DISM ?

Options de Command-Line de gestion des images DISM

Options de gestion et maintenance des images de déploiement (DISM) Command-Line