Поделиться через

Expand-Archive

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

Извлекает файлы из указанного архива (zippped) файла.

Синтаксис

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-файл для упрощения распределения и хранения.

Примеры

Пример 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 использует необработанное значение, найденное в архиве. Это может привести к тому, что имя файла отличается от имени исходного файла, хранящегося в архиве.