Options de ligne de commande de la gestion et maintenance des images de déploiement
Publication: octobre 2009
Mis à jour: octobre 2009
S'applique à: Windows 7
L’outil Gestion et maintenance des images de déploiement (DISM.exe) installe, désinstalle, configure et met à jour les fonctionnalités et packages contenus dans les images système Windows® hors connexion, ainsi que les images système de l’environnement de préinstallation Windows (WinPE) hors connexion. Les commandes et options disponibles pour la maintenance d’une image dépendent du système d’exploitation Windows dont vous effectuez la maintenance Windows® 7, Windows Vista® avec Service Pack 2 (SP2), Windows Vista® avec Service Pack 1 (SP1), Windows Server® 2008 R2, Windows Server® 2008, ou Windows PE ; elles varient également selon qu’il s’agit d’une image hors connexion ou d’un système d’exploitation en cours d’exécution. Toutes les commandes fonctionnent sur une image système Windows hors connexion. Des sous-ensembles des commandes sont disponibles pour la maintenance d’un système d’exploitation en cours d’exécution.
Les options de ligne de commande DISM sont globales et peuvent être utilisées avec la plupart des options de ligne de commande de maintenance. Les options de ligne de commande de maintenance fonctionnent individuellement et ne peuvent pas être associées à d’autres options de ligne de commande de maintenance. La maintenance d’une image système Windows est rendue possible via le montage de l’image ou la spécification d’un système d’exploitation en cours d’exécution.
DISM remplace plusieurs outils du Kit de préinstallation OEM (OPK) Windows (Windows OPK), notamment PEImg, Intlcfg et le Gestionnaire de package.
Options de ligne de commande DISM
Pour effectuer la maintenance d’une image système Windows hors connexion, vous devez d’abord monter l’image. Vous pouvez utiliser les commandes et arguments d’image système Windows (WIM) pour monter une image WIM dont vous assurez la maintenance et la gestion. Vous pouvez également utiliser ces commandes pour lister les index ou vérifier l’architecture de l’image à monter. Une fois l’image mise à jour, vous devez la démonter, puis valider ou ignorer les modifications que vous avez apportées.
Les commandes suivantes peuvent servir à monter, démonter et interroger des fichiers WIM. Ces options ne respectent pas la casse.
| Option | Argument | Description | ||
|---|---|---|---|---|
|
/Mount-Wim
|
/WimFile:<chemin_vers_image.wim> /Index:<index_image> /Name:<nom_image> /MountDir:<chemin_vers_répertoire_montage> /ReadOnly |
Monte le fichier WIM dans le répertoire spécifié de sorte qu’il soit disponible pour la maintenance. /ReadOnly définit des autorisations d’accès en lecture seule pour l’image montée. Facultatif.
Exemple : Dism /Mount-Wim /WimFile:C:\test\images\install.wim /index:1 /MountDir:C:\test\offline /ReadOnly Dism /Mount-Wim /WimFile:C:\test\offline\install.wim /name:"Windows Vista HomeBasic" /MountDir:C:\test\offline |
||
|
/Commit-Wim |
/MountDir:<chemin_vers_répertoire_montage> |
Applique les modifications que vous avez apportées à l’image montée. L’image reste montée tant que l’option /unmount est utilisée. Exemple : Dism /Commit-Wim /MountDir:C:\test\offline |
||
|
/Unmount-Wim |
/MountDir:<chemin_vers_répertoire_montage> {/Commit | /Discard} |
Démonte le fichier WIM, puis valide ou ignore les modifications apportées pendant le montage de l’image. Exemple : Dism /Unmount-Wim /MountDir:C:\test\offline /commit Dism /Unmount-Wim /MountDir:C:\test\offline /discard |
||
|
/Remount-Wim |
/MountDir:<chemin_vers_répertoire_montage> |
Remonte un fichier WIM monté devenu inaccessible et le rend accessible pour la maintenance. Exemple : Dism /Remount-Wim /MountDir:<path_to_mount_directory> |
||
|
/Cleanup-Wim |
Supprime toutes les ressources associées à une image WIM montée qui a été abandonnée. Cette commande ne démonte pas les images actuellement montées et ne supprime pas non plus les images qui peuvent être remontées. Exemple : Dism /Cleanup-Wim |
|||
|
/Get-WimInfo |
/WimFile:<chemin_vers_image.wim> /Index:<index_image> /Name:<nom_image> |
Affiche des informations sur les images contenues dans le fichier WIM. Son utilisation avec l’option /Index ou /Name entraîne l’affichage des informations relatives à l’image spécifiée. Exemple : Dism /Get-WimInfo /WimFile:C:\test\offline\install.wim /index:1 |
||
|
/Get-MountedWimInfo |
|
Liste les images actuellement montées, ainsi que les informations relatives à l’image montée notamment les autorisations d’accès en lecture/écriture, l’emplacement du montage, le chemin d’accès du fichier monté et l’index de l’image montée. Exemple : Dism /Get-MountedWimInfo |
La syntaxe de base est la même pour quasiment toutes les commandes DISM. Une fois que vous avez monté ou appliqué votre image système Windows de sorte qu’elle soit disponible hors connexion en tant que structure de fichier plat, vous pouvez spécifier des options DISM, la commande de maintenance pour la mise à jour de votre image, ainsi que l’emplacement de l’image hors connexion. Vous ne pouvez utiliser qu’une seule commande de maintenance par ligne de commande. Si vous effectuez la maintenance d’un ordinateur en cours d’exécution, vous pouvez utiliser l’option /Online au lieu de spécifier l’emplacement de l’image système Windows hors connexion.
La syntaxe de base pour l’outil DISM est la suivante :
DISM.exe {/Image:<chemin_vers_image> | /Online} [options_dism] {commande_maintenance} [<argument_maintenance>]
Les options DISM suivantes sont disponibles pour une image hors connexion.
DISM.exe /image:<chemin_vers_répertoire_image_hors_connexion> [/WinDir:<chemin_vers_%WINDIR%>] [/LogPath:<chemin_vers_fichier_journal.log>] [/LogLevel:<n>] [SysDriveDir:<chemin_vers_fichier_bootMgr>] [/Quiet] [/NoRestart] [/ScratchDir:<chemin_vers_répertoire_travail>]
Les options DISM suivantes sont disponibles pour un système d’exploitation en cours d’exécution.
DISM.exe /online [/LogPath:<chemin_vers_fichier_journal>] [/LogLevel:<n>] [/Quiet] [/NoRestart] [/ScratchDir:<chemin_vers_répertoire_travail>]
Le tableau suivant décrit de quelle manière chaque option DISM peut être utilisée. Ces options ne respectent pas la casse.
| Option | Description | ||
|---|---|---|---|
|
/Get-Help /? |
Affiche des informations sur les options et arguments de ligne de commande disponibles pour DISM. Les options disponibles pour la maintenance d’une image dépendent de la technologie de maintenance disponible dans votre image. La spécification d’une image, qu’il s’agisse d’une image hors connexion ou du système d’exploitation en cours d’exécution, génère des informations sur les options spécifiques disponibles pour l’image dont vous effectuez la maintenance. Exemple : Dism /? Dism /image:C:\test\offline /? Dism /online /? Vous pouvez afficher une aide supplémentaire en spécifiant une option de ligne de commande. Exemple : Dism /image: C:\test\offline /Add-Driver /? Dism /image:C:\test\offline /Add-Package /? Dism /online /Get-Drivers /? |
||
|
/LogPath:<chemin_vers_fichier_journal.log> |
Spécifie le chemin d’accès complet et le nom du fichier journal. S’il n’est pas défini, la valeur par défaut est : %WINDIR%\Logs\Dism\dism.log
Lors de l’utilisation d’un partage réseau qui n’est pas membre d’un domaine, utilisez la commande net use avec les informations d’identification de domaine pour définir les autorisations d’accès avant de définir le chemin d’accès du journal DISM. Exemple : Dism /image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.cab |
||
|
/LogLevel:<n> |
Spécifie le niveau de sortie maximal affiché dans les journaux. Le niveau de journalisation par défaut est 3. Les valeurs acceptées sont : 1 = Erreurs seulement 2 = Erreurs et avertissements 3 = Erreurs, avertissements et informations 4 = Tous les éléments ci-dessus et la sortie du débogage Exemple : Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab |
||
|
/Image:<chemin_vers_répertoire_image_hors_connexion> |
Il s’agit du chemin d’accès complet du répertoire racine de l’image système Windows hors connexion dont vous devez effectuer la maintenance. Si le répertoire nommé Windows n’est pas un sous-répertoire du répertoire racine, /WinDir doit être spécifié. Cette option ne peut pas être utilisée avec /Online. Exemple : Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab |
||
|
/WinDir:<chemin_vers_%WINDIR%> |
Son utilisation avec l’option /Image permet de spécifier le chemin d’accès du répertoire Windows par rapport au chemin d’accès de l’image. Il ne peut pas s’agir du chemin d’accès complet du répertoire Windows ; il doit s’agir d’un chemin d’accès relatif. S’il n’est pas spécifié, la valeur par défaut est celle du répertoire Windows à la racine du répertoire de l’image hors connexion. Cette option ne peut pas être utilisée avec l’option /Online. Exemple : Dism /image:C:\test\offline /WinDir:WinNT /Add-Package /PackagePath:C:\packages\package.cab |
||
|
/Online |
Spécifie que l’action doit être entreprise sur le système d’exploitation en cours d’exécution. Cette option ne peut pas être utilisée avec l’option /Image ou /WinDir. Lorsque l’option /Online est utilisée, le répertoire Windows de l’image en ligne est automatiquement détecté. Exemple : Dism /online /Get-Packages |
||
|
/SysDriveDir:<chemin_vers_répertoire_sysdrive> |
Spécifie le chemin d’accès de l’emplacement des fichiers BootMgr. Cela est uniquement nécessaire lorsque les fichiers BootMgr se trouvent sur une autre partition que celle qui contient le répertoire Windows et que ces fichiers BootMgr doivent faire l’objet d’une maintenance. Cette option n’est pas nécessaire si vous effectuez la maintenance d’une image appliquée, car les partitions système ne font pas partie du fichier WIM. Exemple : Dism /image:C:\test\offline /SysDriveDir:C:\ |
||
|
/Quiet |
Désactive la sortie des informations et de l’avancement vers la console. Seuls les messages d’erreur sont affichés. Pour s’exécuter en mode silencieux, cette option doit être définie à chaque exécution de l’utilitaire en ligne de commande. Elle doit être présente avant la commande de maintenance.
Exemple : Dism /image:C:\test\offline /Add-Package /PackagePath:C:\packages\package.cab /quiet |
||
|
/NoRestart |
Supprime le redémarrage. Si le redémarrage n’est pas nécessaire, cette commande ne fait rien. Cette option empêche l’application d’inviter l’utilisateur à redémarrer l’ordinateur (ou empêche tout redémarrage automatique, si l’option /Quiet est utilisée). Exemple : Dism /online /Add-Package /PackagePath:C:\packages\package.cab /NoRestart /quiet |
||
|
/ScratchDir:<chemin_vers_répertoire_travail> |
Spécifie un répertoire temporaire à utiliser lors de l’extraction de fichiers temporaires au cours de la maintenance. Le répertoire doit exister localement. S’il n’est pas spécifié, le répertoire \Windows\%Temp% est utilisé, avec un nom de sous-répertoire dont la valeur hexadécimale est générée aléatoirement à chaque exécution de DISM. Les éléments du répertoire de travail sont supprimés après chaque opération. N’utilisez pas l’emplacement d’un partage réseau comme répertoire de travail pour développer un package (fichier .cab ou .msu) dans le cadre d’une installation. Le répertoire utilisé pour l’extraction des fichiers à usage temporaire au cours de la maintenance doit être un répertoire local. Exemple : Dism /image:C:\test\offline /ScratchDir:C:\Scratch /Add-Package /PackagePath:C:\packages\package.cab |
||
|
/English |
Affiche la sortie de la ligne de commande en anglais.
Exemple : Dism /Get-WimInfo /WimFile:C:\test\offline\install.wim /index:1 /English |
Options de ligne de commande de maintenance
En fonction de l’image spécifiée (Windows 7, Windows Vista avec SP2, Windows Vista avec Service Pack 1 (SP1), Windows Server 2008 R2, Windows Server 2008, ou Windows PE) et selon qu’il s’agit d’une image hors connexion ou d’un système d’exploitation en cours d’exécution, les commandes et arguments de maintenance peuvent être disponibles pour les types de mises à jour suivants :
Remarque |
|---|
| Vous ne pouvez pas utiliser deux types de commandes de services de maintenance différents dans la même ligne de commande. |
-
Commandes de maintenance spécifiques à Windows PE pour la préparation d’une image système Windows PE. Pour plus d’informations, voir Options de ligne de commande de maintenance de Windows PE.
-
Commandes de maintenance spécifiques aux pilotes pour l’ajout, la suppression et l’énumération de fichiers .inf de pilotes. Pour plus d’informations, voir Options de ligne de commande de maintenance des pilotes.
-
Commandes de maintenance de packages pour l’ajout, la suppression et l’énumération de packages, ainsi que l’activation, la désactivation et l’énumération de fonctionnalités. Pour plus d’informations, voir Options de ligne de commande de maintenance des packages du système d’exploitation.
-
Commandes de maintenance internationales pour le réglage des configurations et paramètres internationaux. Pour plus d’informations, voir Options de ligne de commande de maintenance internationales et de langues
-
Commandes de maintenance des éditions pour la modification de l’édition de votre image système Windows Pour plus d’informations, voir Options de ligne de commande de maintenance des éditions de Windows.
-
Commandes de maintenance utilisables pour appliquer un fichier Unattend.xml. Pour plus d’informations, voir Options de ligne de commande de maintenance sans assistance.
-
Commandes de maintenance permettant de vérifier si les correctifs d’applications Windows® Installer (fichiers .msp) sont applicables et d’interroger l’image hors connexion pour obtenir des informations sur les applications et correctifs d’applications MSI installés (fichiers .msp). Pour plus d’informations, voir Options de ligne de commande de maintenance des applications.

Remarque