Export-WindowsImage

Export-WindowsImage

Exports a copy of the specified image to another image file.

Syntaxe

Parameter Set: InputByFilePathAndIndex
Export-WindowsImage -DestinationImagePath <String> -SourceImagePath <String> -SourceIndex <UInt32> [-CheckIntegrity] [-CompressionType <String> ] [-DestinationName <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [-Setbootable] [-SplitImageFilePattern <String> ] [-WIMBoot] [ <CommonParameters>]

Parameter Set: InputByFilePathAndName
Export-WindowsImage -DestinationImagePath <String> -SourceImagePath <String> -SourceName <String> [-CheckIntegrity] [-CompressionType <String> ] [-DestinationName <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [-Setbootable] [-SplitImageFilePattern <String> ] [-WIMBoot] [ <CommonParameters>]

Description détaillée

The Export-WindowsImage cmdlet exports a copy of the specified image to another image file. The source and destination files must use the same compression type.

You can also optimize an image by exporting to a new image file with Export-WindowsImage. When you modify an image, DISM stores additional resource files that increase the overall size of the image. Exporting the image will remove unnecessary resource files.

This cmdlet does not apply to virtual hard disk (VHD) files.

Paramètres

-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.

-CompressionType<String>

-DestinationImagePath<String>

Specifies the location of the exported image file.

-DestinationName<String>

Specifies the name of the exported image in the exported image file.

-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

-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.

-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.

-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.

-SourceImagePath<String>

Specifies the location of the source image file.

-SourceIndex<UInt32>

Spécifie le numéro d’index d’une image Windows dans un fichier WIM ou VHD. Pour un fichier VHD, l’index doit être 1.

-SourceName<String>

Specifies the name of the source image in the source image file.

-SplitImageFilePattern<String>

Spécifie l’emplacement et le nom du fichier image fractionné de base.

-WIMBoot

Specifies that the image will be formatted to install on a Windows image file boot (WIMBoot) system.

<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 exports the image at Index 1 of the file C:\imagestore\custom.wim to the file c:\imagestore\export.wim with the name Exported Image.

PS C:\> Export-WindowsImage -SourceImagePath C:\imagestore\custom.wim -SourceIndex 1 -DestinationImagePath c:\imagestore\export.wim -DestinationName "Exported Image"

Rubriques connexes

Dismount-WindowsImage

Expand-WindowsImage

Export-WindowsImage

Get-WindowsImage

Mount-WindowsImage

New-WindowsImage

Remove-WindowsImage

Repair-WindowsImage

Save-WindowsImage

Split-WindowsImage