Freigeben über

Expand-Archive

  • Referenz
Modul:
Microsoft.PowerShell.Archive

Extrahiert Dateien aus einer angegebenen ZIP-Archivdatei.

Syntax

Expand-Archive
      [-Path] <String>
      [[-DestinationPath] <String>]
      [-Force]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Expand-Archive
      -LiteralPath <String>
      [[-DestinationPath] <String>]
      [-Force]
      [-PassThru]
      [-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.

Das Expand-Archive Cmdlet verwendet die System.IO.Compression.ZipArchive-API zum Komprimieren von Dateien. Die API beschränkt die maximale Dateigröße auf 2 GB. Die .NET-API arbeitet mit Dateien zusammen, die der offiziellen ZIP-Dateiformatspezifikation von PKWARE Inc. entsprechen. Weitere Informationen finden Sie unter System.IO.Compression.ZipArchive.

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 Wildcards interpretiert werden können.

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.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:1
Standardwert:A folder in the current location
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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. Wildcardzeichen 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.

Typ:String
Aliase:PSPath
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Bewirkt, dass das Cmdlet eine Liste der Dateien ausgibt, die aus dem Archiv erweitert wurden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad zur Archivdatei an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

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

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

FileSystemInfo

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet eine Liste der Dateien zurück, die aus dem Archiv erweitert wurden.

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.