Remove-WindowsImage
Remove-WindowsImage
Deletes the specified volume image from a WIM file that has multiple volume images.
Syntax
Parameter Set: InputByFilePathAndIndex
Remove-WindowsImage -ImagePath <String> -Index <UInt32> [-CheckIntegrity] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [ <CommonParameters>]
Parameter Set: InputByFilePathAndName
Remove-WindowsImage -ImagePath <String> -Name <String> [-CheckIntegrity] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [ <CommonParameters>]
Detaillierte Beschreibung
The Remove-WindowsImage cmdlet deletes the specified volume image from a WIM file that has multiple volume images. This cmdlet deletes only the metadata entries and XML entries. It does not delete the stream data and does not optimize the WIM file.
This command-line option 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.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-ImagePath<String>
Specifies the location of a WIM file.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Index<UInt32>
Gibt die Indexnummer eines Windows-Abbilds in einer WIM- oder VHD-Datei an. Für eine VHD-Datei muss der Index 1 sein.
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 |
-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 |
<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.ImageObject
Beispiele
Example 1
This command removes the first image in c:\imagestore\custom.wim.
PS C:\> Remove-WindowsImage -ImagePath c:\imagestore\custom.wim -Index 1 -CheckIntegrity
Example 2
This command removes the image named Starter that is located in c:\imagestore\custom.wim.
PS C:\> Remove-WindowsImage -ImagePath c:\imagestore\custom.wim -Name "Starter" -CheckIntegrity