Add-WindowsImage
Add-WindowsImage
Adds an additional image to an existing image (.wim) file.
Syntaxe
Parameter Set: Default
Add-WindowsImage -CapturePath <String> -ImagePath <String> -Name <String> [-CheckIntegrity] [-ConfigFilePath <String> ] [-Description <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-NoRpFix] [-ScratchDirectory <String> ] [-Setbootable] [-Verify] [-WIMBoot] [ <CommonParameters>]
Description détaillée
The Add-WindowsImage cmdlet adds an additional image to an existing image (.wim) file. Add-WindowsImage compares new files to the resources in the existing .wim file, specified by the Name parameter and the ImagePath parameter, and stores only a single copy of each unique file so that each file is only captured once. The .wim file can have only one assigned compression type. Therefore, you can only append files with the same compression type.
The Add-WindowsImage cmdlet does not apply to virtual hard disk (VHD) files.
It’s important to note that you’ll need to ensure you have enough disk space before you run Add-WindowsImage. If you run out of disk space while the image is being appended, you might corrupt the .wim file.
Paramètres
-CapturePath<String>
Specifies the path to the location of the new files that will be compared to the resources in the existing .wim file.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-CheckIntegrity
Détecte et effectue le suivi des fichiers .wim endommagés quand il est utilisé avec l’applet de commande Add—WindowsImage, Dismount-WindowsImage ou Save-WindowsImage. CheckIntegrity arrête l’opération si DISM détecte que le fichier .wim est endommagé quand il est utilisé avec l’applet de commande Expand-WindowsImage ou Mount-WindowsImage.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-ConfigFilePath<String>
Spécifie l’emplacement du fichier de configuration qui répertorie les exclusions pour les commandes de capture et de compression des images. Pour plus d’informations, consultez Fichiers de listes de configuration et fichiers WimScrit.ini de DISM, https://go.microsoft.com/fwlink/?LinkID=313768.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Description<String>
Specifies the description of the image to be captured.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-ImagePath<String>
Specifies the location of the WIM file containing the Windows image you want to compare against the new files.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-LogLevel<LogLevel>
Spécifie le niveau de sortie maximal enregistré dans les journaux. Le niveau de journalisation par défaut est 3. Les valeurs acceptées sont les suivantes :1 = erreurs uniquement2 = erreurs et avertissements3 = erreurs, avertissements et informations4 = toutes les informations répertoriées plus haut, plus la sortie du débogage
Alias |
LL |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-LogPath<String>
Spécifie le chemin et le nom de fichier complets où consigner la journalisation. S’il n’est pas défini, la valeur par défaut est %WINDIR%\Logs\Dism\dism.log
.Dans Windows PE, le répertoire par défaut est l’espace de travail RAMDISK; dont la taille peut être de seulement 32 Mo. Le fichier journal est archivé automatiquement. Le fichier journal archivé est enregistré avec l’extension .bak ajoutée au nom de fichier et un nouveau fichier journal est généré. Chaque fois que le fichier journal est archivé, le fichier .bak est remplacé. Quand vous utilisez un partage réseau qui n’est pas joint à un domaine, utilisez la commande net use avec des informations d’identification de domaine pour définir les autorisations d’accès avant de définir le chemin du journal DISM.
Alias |
LP |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Name<String>
Specifies the name of an image in a WIM file.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-NoRpFix
Désactive le correctif de la balise de point d’analyse. Un point d’analyse est un fichier qui contient un lien vers un autre fichier sur le système de fichiers. Si le paramètre n’est pas spécifié, les points d’analyse qui se résolvent en chemins d’accès en dehors de la valeur spécifiée par le paramètre ImagePath ne seront pas capturés.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-ScratchDirectory<String>
Spécifie un répertoire temporaire qui sera utilisé lors de l’extraction de fichiers à utiliser pendant la maintenance. Le répertoire doit exister localement. S’il n’est pas spécifié, le répertoire \Windows\%Temp%
sera utilisé, avec comme nom de sous-répertoire une valeur hexadécimale générée de manière aléatoire pour chaque exécution de DISM. Les éléments du répertoire de travail sont supprimés après chaque opération. Vous ne devez pas utiliser un emplacement de partage réseau comme répertoire de travail pour développer un package (fichier .cab ou .msu) en vue d’une installation. Le répertoire utilisé pour l’extraction des fichiers à usage temporaire pendant la maintenance doit être un répertoire local.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Setbootable
Marque une image de volume comme image démarrable. Cet argument est disponible seulement pour les images Windows PE. Une seule image de volume peut être marquée comme démarrable dans un fichier .wim.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Verify
Recherche les erreurs et les fichiers dupliqués. Au cours d’une opération d’application, par exemple lors de l’utilisation de l’applet de commande Add-WindowsImage, la taille et le hachage du fichier à appliquer sont contrôlés par rapport au fichier image pour vérifier qu’ils sont égaux. Au cours d’une opération de capture, par exemple lors de l’utilisation de l’applet de commande New-WindowsImage, une fois les fichiers capturés dans une image Windows, le fichier est écrit dans un fichier temporaire et comparé bit par bit au fichier d’origine.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-WIMBoot
Specifies that the offline image to be added will be formatted to install on a Windows Image Format Boot (WIMBoot) system.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.
- System.String[]
- Microsoft.Dism.Commands.ImageObject
- Microsoft.Dism.Commands.ImageObjectWithState
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
- Microsoft.Dism.Commands.OfflineImageObject
Exemples
Example 1
This command adds files from d:\”Drive D” to the existing image at c:\imagestore\custom.wim
PS C:\> Add-WindowsImage -ImagePath c:\imagestore\custom.wim -CapturePath d:\ -Name "Drive D"