Sdílet prostřednictvím

Expand-Archive

  • Reference
Modul:
Microsoft.PowerShell.Archive

Extrahuje soubory ze zadaného souboru archivu ZIP.

Syntaxe

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

Description

Rutina Expand-Archive extrahuje soubory ze zadaného souboru zipped archivu do zadané cílové složky. Archivní soubor umožňuje balení více souborů a volitelně je komprimovat do jednoho komprimovaného souboru pro snadnější distribuci a ukládání.

Rutina Expand-Archive používá k komprimaci souborů rozhraní API System.IO.Compression.ZipArchive . Rozhraní API omezuje maximální velikost souboru na 2 GB. Rozhraní .NET API pracuje se soubory, které odpovídají oficiální specifikaci formátu ZIP společnosti PKWARE Inc. Další informace naleznete v tématu System.IO.Compression.ZipArchive.

Příklady

Příklad 1: Extrahování obsahu archivu

Tento příklad extrahuje obsah existujícího souboru archivu do složky určené parametrem DestinationPath .

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

V tomto příkladu se používá parametr LiteralPath , protože název souboru obsahuje znaky, které lze interpretovat jako zástupné znaky.

Příklad 2: Extrahování obsahu archivu v aktuální složce

Tento příklad extrahuje obsah existujícího souboru archivu v aktuální složce do složky určené parametrem DestinationPath .

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

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DestinationPath

Ve výchozím nastavení Expand-Archive vytvoří složku v aktuálním umístění, které má stejný název jako soubor ZIP. Parametr umožňuje zadat cestu k jiné složce. Cílová složka se vytvoří, pokud neexistuje.

Typ:String
Position:1
Default value:A folder in the current location
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Tento parametr použijte k přepsání existujících souborů. Ve výchozím nastavení Expand-Archive se nepřepíše.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LiteralPath

Určuje cestu k souboru archivu. Na rozdíl od parametru Path se hodnota LiteralPath používá přesně tak, jak je zadaná. Zástupné znaky nejsou podporované. Pokud cesta obsahuje řídicí znaky, uzavřete každý řídicí znak do jednoduchých uvozovek, aby PowerShell neinterpretoval žádné znaky jako řídicí sekvence.

Typ:String
Aliasy:PSPath
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Způsobí, že rutina vypíše seznam souborů rozbalených z archivu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

Určuje cestu k souboru archivu.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Řetězec, který obsahuje cestu k existujícímu archivačnímu souboru, můžete pipetovat.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

FileSystemInfo

Když použijete parametr PassThru , vrátí tato rutina seznam souborů, které byly rozbalené z archivu.

Poznámky

Rutina Compress-Archive používá kódování UTF-8. Jiné nástroje archivu ZIP můžou používat jiné schéma kódování. Při extrahování souborů s názvy souborů, které nejsou uloženy pomocí kódování UTF-8, Expand-Archive používá nezpracovanou hodnotu nalezenou v archivu. Výsledkem může být název souboru, který se liší od zdrojového názvu souboru uloženého v archivu.