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

Примеры

Пример 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

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

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

-DestinationPath

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

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

-Force

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

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

-LiteralPath

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

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

-PassThru

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

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

-Path

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

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

-WhatIf

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

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

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

String

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

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

None

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

FileSystemInfo

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

Примечания

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