Add-WindowsImage
Add-WindowsImage
Adds an additional image to an existing image (.wim) file.
Syntax
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>]
Detaillierte Beschreibung
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.
Parameter
-CapturePath<String>
Specifies the path to the location of the new files that will be compared to the resources in the existing .wim file.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-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.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-ConfigFilePath<String>
Gibt den Speicherort einer Konfigurationsdatei an, die Ausschlüsse für Abbilderfassung und Komprimierungsbefehle auflistet. Weitere Informationen finden Sie unter „DISM-Konfigurationslistendatei und Datei 'WimScript.ini'“, https://go.microsoft.com/fwlink/?LinkID=313768.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Description<String>
Specifies the description of the image to be captured.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-ImagePath<String>
Specifies the location of the WIM file containing the Windows image you want to compare against the new files.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-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
Aliasse |
LL |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-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.
Aliasse |
LP |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Name<String>
Specifies the name of an image in a WIM file.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-NoRpFix
Deaktiviert die Reparatur des Analysepunktkennzeichens. Ein Analysepunkt ist eine Datei, die einen Link zu einer anderen Datei im Dateisystem enthält. Wenn der Parameter nicht angegeben wird, werden die Analysepunkte, die in Pfade außerhalb des vom ImagePath-Parameter angegebenen Werts aufgelöst werden, nicht erfasst.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-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.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-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.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Verify
Überprüft auf Fehler und Dateiduplizierung. Während eines Anwendungsvorgangs, z. B. Verwendung des Cmdlets „Add-WindowsImage“, werden Größe und Hash der angewendeten Datei anhand der Abbilddatei geprüft, um sicherzustellen, dass sie gleich sind. Während eines Erfassungsvorgangs, z. B. bei Verwendung des Cmdlets „New-WindowsImage“, wird die Datei, nachdem die Dateien in einem Windows-Abbild erfasst sind, in eine temporäre Datei geschrieben und Bit für Bit mit der ursprünglichen Datei verglichen.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-WIMBoot
Specifies that the offline image to be added will be formatted to install on a Windows Image Format Boot (WIMBoot) system.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
<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 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"