Expand-Archive
從指定的封存盤案中擷取檔案。
語法
Path (預設值)
Expand-Archive
[-Path] <String>
[[-DestinationPath] <String>]
[-Force]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
LiteralPath
Expand-Archive
[[-DestinationPath] <String>]
-LiteralPath <String>
[-Force]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Expand-Archive Cmdlet 會將檔案從指定的壓縮封存盤案擷取至指定的目的地資料夾。 封存盤案允許將多個檔案封裝並選擇性地壓縮成單一壓縮檔，以方便散發和儲存。
範例
範例 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 |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DestinationPath
根據預設，Expand-Archive 會在與 ZIP 檔案同名的目前位置中建立資料夾。 參數可讓您指定不同資料夾的路徑。 如果目標資料夾不存在，則會建立它。
參數屬性
| 類型: | String |
| 預設值: | A folder in the current location |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
使用此參數覆寫現有的檔案。 根據預設，Expand-Archive 不會覆寫。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LiteralPath
指定封存盤案的路徑。 與 Path 參數不同，LiteralPath 的值會與類型完全相同。 不支援通配符。 如果路徑包含逸出字元，請以單引弧括住每個逸出字元，以指示PowerShell不要將任何字元解譯為逸出序列。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | PSPath |
參數集
LiteralPath
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PassThru
導致 Cmdlet 輸出從封存展開的檔案清單。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
指定封存盤案的路徑。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Path
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 該 Cmdlet 未被執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
String
您可以使用管線傳送包含現有封存盤案路徑的字串。
輸出
None
根據預設，此 Cmdlet 不會傳回任何輸出。
FileSystemInfo
當您使用 PassThru 參數時，此 Cmdlet 會傳回從封存展開的檔案清單。
備註
Compress-Archive Cmdlet 使用 UTF-8 編碼。 其他 ZIP 封存工具可能會使用不同的編碼配置。 使用UTF-8編碼擷取檔名的檔案時，Expand-Archive 會使用封存中找到的原始值。 這可能會導致檔名與封存中儲存的來源檔名不同。
