Udostępnij za pośrednictwem

Expand-Archive

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

Wyodrębnia pliki z określonego pliku archiwum (zipped).

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 cmdlet Expand-Archive 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.

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 można interpretować 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 tworzy folder w bieżącej lokalizacji, która jest taka sama jak 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ść 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, jeśli polecenie cmdlet zostanie uruchomione. 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

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

Uwagi

Polecenie cmdlet Compress-Archive 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.