Expand-Archive
Extrahuje soubory ze zadaného souboru archivu (zipped).
Syntaxe
Path (Výchozí)
Expand-Archive
[-Path] <String>
[[-DestinationPath] <String>]
[-Force]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
LiteralPath
Expand-Archive
[[-DestinationPath] <String>]
-LiteralPath <String>
[-Force]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Expand-Archive extrahuje soubory ze zadaného souboru komprimovaného 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í.
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 cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String |
| Default value: | A folder in the current location |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Tento parametr použijte k přepsání existujících souborů. Ve výchozím nastavení Expand-Archive nepřepisuje.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje cestu k souboru archivu. Na rozdíl od parametru Path se hodnota LiteralPath používá přesně tak, jak je zadána. Zástupné znaky nejsou podporovány. Pokud cesta obsahuje řídicí znaky, uzavřete každý řídicí znak do jednoduchých uvozovek, aby PowerShell neinterpretoval žádné znaky jako řídicí sekvence.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
LiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Způsobí, že rutina vypíše seznam souborů rozbalených z archivu.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje cestu k souboru archivu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Path
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Cmdlet se nespustil.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
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ů rozbalených 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žije 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.
