Expand-Archive

  • Referenz
Modul:
Microsoft.PowerShell.Archive

Extrahiert Dateien aus einer angegebenen Archivdatei (zipped).

Syntax

Expand-Archive
      [-Path] <String>
      [[-DestinationPath] <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Expand-Archive
      -LiteralPath <String>
      [[-DestinationPath] <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Expand-Archive Cmdlet extrahiert Dateien aus einer angegebenen zippten Archivdatei in einen angegebenen Zielordner. Mit einer Archivdatei können mehrere Dateien gepackt und optional in eine einzelne zippierte Datei komprimiert werden, um die Verteilung und Speicherung zu vereinfachen.

Beispiele

Beispiel 1: Extrahieren des Inhalts eines Archivs

In diesem Beispiel wird der Inhalt einer vorhandenen Archivdatei in den durch den Parameter DestinationPath angegebenen Ordner extrahiert.

Expand-Archive -LiteralPath 'C:\Archives\Draft[v1].zip' -DestinationPath C:\Reference

In diesem Beispiel wird der LiteralPath-Parameter verwendet, da der Dateiname Zeichen enthält, die als wild interpretiert werden können Karte s.

Beispiel 2: Extrahieren des Inhalts eines Archivs im aktuellen Ordner

In diesem Beispiel wird der Inhalt einer vorhandenen Archivdatei im aktuellen Ordner in den durch den DestinationPath-Parameter angegebenen Ordner extrahiert.

Expand-Archive -Path Draftv2.zip -DestinationPath C:\Reference

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationPath

Erstellt standardmäßig Expand-Archive einen Ordner am aktuellen Speicherort, der denselben Namen wie die ZIP-Datei hat. Mit dem Parameter können Sie den Pfad zu einem anderen Ordner angeben. Der Zielordner wird erstellt, wenn er nicht vorhanden ist.

Type:String
Position:1
Default value:A folder in the current location
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Verwenden Sie diesen Parameter, um vorhandene Dateien zu überschreiben. Wird standardmäßig Expand-Archive nicht überschrieben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Gibt den Pfad zu einer Archivdatei an. Im Gegensatz zum Path-Parameter wird der Wert von LiteralPath genau so verwendet, wie er eingegeben wird. Wild Karte Zeichen werden nicht unterstützt. Wenn der Pfad Escapezeichen enthält, schließen Sie jedes Escapezeichen in einfache Anführungszeichen ein, um PowerShell anzuweisen, keine Zeichen als Escapesequenzen zu interpretieren.

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Gibt den Pfad zur Archivdatei an.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Sie können eine Zeichenfolge senden, die einen Pfad zu einer vorhandenen Archivdatei enthält.

Ausgaben

None

Hinweise

Das Compress-Archive Cmdlet verwendet UTF-8-Codierung. Andere ZIP-Archivtools können ein anderes Codierungsschema verwenden. Beim Extrahieren von Dateien mit Dateinamen, die nicht mit UTF-8-Codierung gespeichert sind, Expand-Archive wird der im Archiv gefundene Rohwert verwendet. Dies kann zu einem Dateinamen führen, der sich von dem im Archiv gespeicherten Quelldateinamen unterscheidet.