Export-WindowsImage

Export-WindowsImage

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

Syntax

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

Detaillierte Beschreibung

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.

Parameter

-CheckIntegrity

Ermittelt und verfolgt die Beschädigung der WIM-Datei bei Verwendung mit dem Add-WindowsImage-, Dismount-WindowsImage- oder Save-WindowsImage-Cmdlet. „CheckIntegrity“ beendet bei Verwendung mit dem Expand-WindowsImage- oder Mount-WindowsImage-Cmdlet den Vorgang, wenn DISM erkennt, dass die WIM-Datei beschädigt ist.

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

Gibt die in den Protokollen angezeigte maximale Ausgabestufe an. Die Standardprotokollstufe ist 3. Die zulässigen Werte lauten wie folgt:1 = nur Fehler2 = Fehler und Warnungen3 = Fehler, Warnungen und Informationen4 = alle zuvor genannten Informationen sowie Debugausgabe

-LogPath<String>

Gibt den vollständigen Pfad und Dateinamen zum Anmelden an. Ohne besondere Festlegung ist der Standardwert %WINDIR%\Logs\Dism\dism.log.In Windows PE ist der RAMDISK-Speicherbereich, der 32 MB klein sein kann, das Standardverzeichnis. Die Protokolldatei wird automatisch archiviert. Die archivierte Protokolldatei wird mit der Dateiendung „.bak“ gespeichert, und eine neue Protokolldatei wird generiert. Bei jeder Archivierung der Protokolldatei wird die BAK-Datei überschrieben. Wenn Sie eine Netzwerkfreigabe verwenden, die nicht Mitglied einer Domäne ist, verwenden Sie den Befehl „net use“ zusammen mit den Domänenanmeldeinformationen, um Zugriffsberechtigungen festlegen, bevor Sie den Protokollpfad für das DISM-Protokoll festlegen.

-ScratchDirectory<String>

Gibt ein temporäres Verzeichnis an, das beim Extrahieren von Dateien während der Wartung verwendet wird. Das Verzeichnis muss lokal vorhanden sein. Wenn nicht angegeben, wird das Verzeichnis \Windows\%Temp% verwendet, mit einem Unterverzeichnisnamen auf Basis eines für jede Ausführung von DISM zufällig generierten Hexadezimalwerts. Elemente im Scratchverzeichnis werden nach jedem Vorgang gelöscht. Sie sollten keine Netzwerkfreigabe als Scratchverzeichnis verwenden, um ein Paket (CAB- oder MSU-Datei) für die Installation zu erweitern. Das Verzeichnis für das Extrahieren von Dateien für die temporäre Verwendung während der Wartung sollte ein lokales Verzeichnis sein.

-Setbootable

Kennzeichnet ein Volumeabbild als startbares Abbild. Dieses Argument ist nur für Windows PE-Abbilder verfügbar. In einer WIM-Datei kann nur ein Volumeabbild als startbar gekennzeichnet werden.

-SourceImagePath<String>

Specifies the location of the source image file.

-SourceIndex<UInt32>

Gibt die Indexnummer eines Windows-Abbilds in einer WIM- oder VHD-Datei an. Für eine VHD-Datei muss der Index 1 sein.

-SourceName<String>

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

-SplitImageFilePattern<String>

Gibt den Speicherort und Namen der grundlegenden geteilten Abbilddatei an.

-WIMBoot

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

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

• System.String[]
• Microsoft.Dism.Commands.ImageObject
• Microsoft.Dism.Commands.ImageObjectWithState

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• Microsoft.Dism.Commands.OfflineImageObject

Beispiele

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"

Verwandte Themen

Dismount-WindowsImage

Expand-WindowsImage

Export-WindowsImage

Get-WindowsImage

Mount-WindowsImage

New-WindowsImage

Remove-WindowsImage

Repair-WindowsImage

Save-WindowsImage

Split-WindowsImage