Expand-Archive

  • Ссылка
Модуль:
Microsoft.PowerShell.Archive

Извлекает файлы из указанного ZIP-архивного файла.

Синтаксис

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

Описание

Командлет Expand-Archive извлекает файлы из указанного архивного файла в указанную целевую папку. Файл архива позволяет упаковать и при необходимости сжать несколько файлов в один сжатый ZIP-файл для упрощения распространения и хранения.

Командлет Expand-Archive использует API System.IO.Compression.ZipArchive для сжатия файлов. API ограничивает максимальный размер файла до 2 ГБ. API .NET работает с файлами, которые соответствуют официальной спецификации формата ZIP-файла PKWARE Inc. Дополнительные сведения см. в разделе System.IO.Compression.ZipArchive.

Примеры

Пример 1. Извлечение содержимого архива

В этом примере извлекается содержимое существующего архивного файла в папку, указанную параметром DestinationPath .

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

В этом примере используется параметр LiteralPath, так как имя файла содержит символы, которые можно интерпретировать как подстановочные знаки.

Пример 2. Извлечение содержимого архива в текущей папке

В этом примере извлекается содержимое существующего архивного файла в текущей папке в папку, указанную параметром DestinationPath .

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

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestinationPath

По умолчанию Expand-Archive создает папку в текущем расположении с тем же именем, что и ZIP-файл. Параметр позволяет указать путь к другой папке. Целевая папка создается, если она не существует.

Тип:String
Position:1
Default value:A folder in the current location
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Используйте этот параметр для перезаписи существующих файлов. По умолчанию Expand-Archive не перезаписывается.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LiteralPath

Определяет путь к файлу архива. В отличие от параметра Path, значение LiteralPath используется точно так же, как и типизированный. Подстановочные знаки не поддерживаются. Если путь содержит escape-символы, заключите каждый escape-символ в одинарные кавычки, чтобы указать PowerShell не интерпретировать какие-либо символы как escape-последовательности.

Тип:String
Aliases:PSPath
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PassThru

Вызывает вывод списка файлов, развернутых из архива, командлета.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

Указывает путь к файлу архива.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

Строку, содержащую путь, можно передать по конвейеру в существующий файл архива.

Выходные данные

None

По умолчанию этот командлет не возвращает выходные данные.

FileSystemInfo

При использовании параметра PassThru этот командлет возвращает список файлов, развернутых из архива.

Примечания

Командлет Compress-Archive использует кодировку UTF-8. Другие средства ZIP-архива могут использовать другую схему кодирования. При извлечении файлов с именами файлов, не хранящихся в кодировке UTF-8, Expand-Archive используется необработанное значение, найденное в архиве. Это может привести к тому, что имя файла отличается от имени исходного файла, хранящегося в архиве.