Udostępnij za pośrednictwem

Expand-Archive

  • Odwołanie
Moduł:
Microsoft.PowerShell.Archive

Wyodrębnia pliki z określonego pliku archiwum ZIP.

Składnia

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

Opis

Polecenie Expand-Archive cmdlet wyodrębnia pliki z określonego spakowanego pliku archiwum do określonego folderu docelowego. Plik archiwum umożliwia spakowanie wielu plików i opcjonalnie skompresowane w jeden spakowany plik w celu łatwiejszej dystrybucji i magazynowania.

Polecenie Expand-Archive cmdlet używa interfejsu API System.IO.Compression.ZipArchive do kompresowania plików. Interfejs API ogranicza maksymalny rozmiar pliku do 2 GB. Interfejs API .NET współpracuje z plikami zgodnymi ze specyfikacją oficjalnego formatu pliku ZIP firmy PKWARE Inc. Aby uzyskać więcej informacji, zobacz System.IO.Compression.ZipArchive.

Przykłady

Przykład 1. Wyodrębnianie zawartości archiwum

W tym przykładzie wyodrębnia zawartość istniejącego pliku archiwum do folderu określonego przez parametr DestinationPath .

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

W tym przykładzie jest używany parametr LiteralPath , ponieważ nazwa pliku zawiera znaki, które mogą być interpretowane jako symbole wieloznaczne.

Przykład 2. Wyodrębnianie zawartości archiwum w bieżącym folderze

W tym przykładzie wyodrębnia zawartość istniejącego pliku archiwum w bieżącym folderze do folderu określonego przez parametr DestinationPath .

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

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DestinationPath

Domyślnie Expand-Archive program tworzy folder w bieżącej lokalizacji o tej samej nazwie co plik ZIP. Parametr umożliwia określenie ścieżki do innego folderu. Folder docelowy jest tworzony, jeśli nie istnieje.

Typ:String
Position:1
Domyślna wartość:A folder in the current location
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Użyj tego parametru, aby zastąpić istniejące pliki. Domyślnie Expand-Archive nie zastępuje.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LiteralPath

Określa ścieżkę do pliku archiwum. W przeciwieństwie do parametru Path wartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Symbole wieloznaczne nie są obsługiwane. Jeśli ścieżka zawiera znaki ucieczki, należy ująć każdy znak ucieczki w pojedynczy cudzysłów, aby program PowerShell nie interpretował żadnych znaków jako sekwencji ucieczki.

Typ:String
Aliasy:PSPath
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PassThru

Powoduje, że polecenie cmdlet wyprowadza listę plików rozwiniętych z archiwum.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Określa ścieżkę do pliku archiwum.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz potokować ciąg zawierający ścieżkę do istniejącego pliku archiwum.

Dane wyjściowe

None

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

FileSystemInfo

Gdy używasz parametru PassThru , to polecenie cmdlet zwraca listę plików, które zostały rozwinięte z archiwum.

Uwagi

Polecenie Compress-Archive cmdlet używa kodowania UTF-8. Inne narzędzia archiwum ZIP mogą używać innego schematu kodowania. Podczas wyodrębniania plików z nazwami plików, które nie są przechowywane przy użyciu kodowania UTF-8, Expand-Archive używa wartości pierwotnej znalezionej w archiwum. Może to spowodować, że nazwa pliku różni się od nazwy pliku źródłowego przechowywanego w archiwum.