共用方式為

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

Description

Cmdlet 會將 Expand-Archive 檔案從指定的壓縮封存盤案擷取至指定的目的地資料夾。 封存盤案允許將多個檔案封裝並選擇性地壓縮成單一壓縮檔，以方便散發和儲存。

Cmdlet Expand-Archive 會使用 System.IO.Compression.ZipArchive API 來壓縮檔案。 API 會將檔案大小上限限製為 2GB。 .NET API 適用於 PKWARE Inc. 符合官方 ZIP 檔案格式規格的檔案。如需詳細資訊，請參閱 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

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DestinationPath

根據預設， Expand-Archive 在與 ZIP 檔案同名的目前位置中建立資料夾。 參數可讓您指定不同資料夾的路徑。 如果目標資料夾不存在，則會建立它。

類型:String
Position:1
預設值:A folder in the current location
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

使用此參數覆寫現有的檔案。 根據預設， Expand-Archive 不會覆寫。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LiteralPath

指定封存盤案的路徑。 與 Path 參數不同，LiteralPath 的值會與輸入時完全相同。 不支援通配符。 如果路徑包含逸出字元，請以單引弧括住每個逸出字元，以指示PowerShell不要將任何字元解譯為逸出序列。

類型:String
別名:PSPath
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-PassThru

導致 Cmdlet 輸出從封存展開的檔案清單。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

指定封存盤案的路徑。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

您可以使用管線傳送包含現有封存盤案路徑的字串。

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

FileSystemInfo

當您使用 PassThru 參數時，此 Cmdlet 會傳回從封存展開的檔案清單。

備註

Cmdlet Compress-Archive 使用 UTF-8 編碼。 其他 ZIP 封存工具可能會使用不同的編碼配置。 擷取檔名未使用 UTF-8 編碼方式儲存的檔案時， Expand-Archive 會使用封存中找到的原始值。 這可能會導致檔名與封存中儲存的來源檔名不同。