Expand-Archive
Wyodrębnia pliki z określonego pliku archiwum (zipped).
Składnia
Path (Domyślne)
Expand-Archive
[-Path] <String>
[[-DestinationPath] <String>]
[-Force]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
LiteralPath
Expand-Archive
[[-DestinationPath] <String>]
-LiteralPath <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
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | False |
| Wspiera dzikie karty: | False |
| DontShow: | False |
| Aliasy: | por |
Zbiory parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z pipeline: | False |
| Wartość z pipeline według nazwy właściwości: | False |
| Wartość pozostałych argumentów: | 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.
Właściwości parametrów
| Typ: | String |
| Wartość domyślna: | A folder in the current location |
| Wspiera dzikie karty: | False |
| DontShow: | False |
Zbiory parametrów
(All)
| Pozycja: | 1 |
| Obowiązkowy: | False |
| Wartość z pipeline: | False |
| Wartość z pipeline według nazwy właściwości: | False |
| Wartość pozostałych argumentów: | False |
-Force
Użyj tego parametru, aby zastąpić istniejące pliki. Domyślnie Expand-Archive nie zastępuje.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | None |
| Wspiera dzikie karty: | False |
| DontShow: | False |
Zbiory parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z pipeline: | False |
| Wartość z pipeline według nazwy właściwości: | False |
| Wartość pozostałych argumentów: | False |
-LiteralPath
Określa ścieżkę do pliku archiwum. W przeciwieństwie do parametru path
Właściwości parametrów
| Typ: | String |
| Wartość domyślna: | None |
| Wspiera dzikie karty: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Zbiory parametrów
LiteralPath
| Pozycja: | Named |
| Obowiązkowy: | True |
| Wartość z pipeline: | False |
| Wartość z pipeline według nazwy właściwości: | True |
| Wartość pozostałych argumentów: | False |
-PassThru
Powoduje, że polecenie cmdlet wyprowadza listę plików rozwiniętych z archiwum.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | None |
| Wspiera dzikie karty: | False |
| DontShow: | False |
Zbiory parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z pipeline: | False |
| Wartość z pipeline według nazwy właściwości: | False |
| Wartość pozostałych argumentów: | False |
-Path
Określa ścieżkę do pliku archiwum.
Właściwości parametrów
| Typ: | String |
| Wartość domyślna: | None |
| Wspiera dzikie karty: | False |
| DontShow: | False |
Zbiory parametrów
Path
| Pozycja: | 0 |
| Obowiązkowy: | True |
| Wartość z pipeline: | True |
| Wartość z pipeline według nazwy właściwości: | True |
| Wartość pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | False |
| Wspiera dzikie karty: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zbiory parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z pipeline: | False |
| Wartość z pipeline według nazwy właściwości: | False |
| Wartość pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Wejścia
String
Możesz potokować ciąg zawierający ścieżkę do istniejącego pliku archiwum.
Wyjść
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.
Notatki
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.
