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 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.

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:1
Default value:A folder in the current location
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.