MSIXMGR 工具參數
本文包含您可以搭配 MSIXMGR 工具使用的命令列參數和語法。
必要條件
若要使用 MSIXMGR 工具，您需要：
- 下載 MSIXMGR 工具。
- 取得 MSIX 封裝的應用程式 (
.msix檔案)。 - 具有系統管理權限的 Windows 裝置，可建立 MSIX 映像。
-AddPackage
在指定的檔案路徑新增套件。
-AddPackage <Path to the MSIX package>
或
-p <Path to the MSIX package>
以下是使用 -AddPackage 參數的範例：
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix"
-RemovePackage
移除具有指定套件完整名稱的套件。
-RemovePackage <Package name>
或
-x <Package name>
以下是使用 -RemovePackage 參數的範例。 您可以執行 PowerShell Cmdlet Get-AppxPackage 來尋找套件完整名稱。
msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe
-FindPackage
尋找具有指定套件完整名稱的套件。
-FindPackage <Package name>
以下是使用 -FindPackage 參數的範例。 您可以執行 PowerShell Cmdlet Get-AppxPackage 來尋找套件完整名稱。
msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe
-ApplyACLs
將 ACL 套用至套件資料夾 (解除封裝的套件)。 您也需要指定下列必要的子參數：
| 必要的 參數 | 描述 |
|---|---|
-packagePath |
要解除封裝的套件路徑，或目錄的路徑 (包含多個要解除封裝的套件) |
-ApplyACLs -packagePath <Path to the package folder>
以下是使用 -ApplyACLs 參數的範例：
msixmgr.exe -ApplyACLs -packagePath "C:\MSIX\myapp_0.0.0.1_x64__8wekyb3d8bbwe"
-Unpack
以 .appx、.msix、.appxbundle 或 .msixbundle 其中一種檔案格式將套件解除封裝，並將其內容解壓縮到資料夾。 您也需要指定下列必要的子參數：
| 必要的 參數 | 描述 |
|---|---|
-destination |
要放置所產生套件資料夾的目錄。 |
-fileType |
要將套件解除封裝的檔案類型。 有效的檔案類型包括 .vhd、.vhdx、.cim。 僅在解除封裝至 CIM 檔案時，才需要此參數。 |
-packagePath |
要解除封裝的套件路徑，或目錄的路徑 (包含多個要解除封裝的套件)。 |
-rootDirectory |
指定要將套件解除封裝至映像上的根目錄。 僅在解除封裝至新的和現有的 CIM 檔案時，才需要此參數。 |
-Unpack -packagePath <Path to package to unpack OR path to a directory containing multiple packages to unpack> -destination <Directory to place the resulting package folder(s) in> -fileType <VHD | VHDX | CIM> -rootDirectory <Root directory on image to unpack packages to>
以下是使用 -Unpack 參數的一些範例：
若要將套件解除封裝到目錄：
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp"若要將套件解除封裝至 VHDX 磁碟映像：
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.vhdx" -applyACLs -create -filetype VHDX -rootDirectory apps若要將套件解除封裝至 CIM 磁碟映像：
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.cim" -applyACLs -create -filetype CIM -rootDirectory apps
以下是您可以搭配 -Unpack 參數使用的選擇性參數：
| 選擇性參數 | 描述 | 範例 |
|---|---|---|
-applyACLs |
將 ACL 套用至產生的套件資料夾及其父資料夾。 | msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs |
-create |
使用指定的檔案類型建立新的映像，並將套件解除封裝至該映像。 需要 -filetype 參數。 |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX |
-fileType |
要將套件解除封裝的檔案類型。 有效的檔案類型包括 VHD、VHDX、CIM。 解除封裝至 CIM 檔案時，需要此參數。 需要 -create 參數。 |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps |
-rootDirectory |
指定要將套件解除封裝至映像上的根目錄。 在解除封裝至新的和現有的 CIM 檔案時，需要此參數。 | msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps |
-validateSignature |
先驗證套件的簽章檔案後，再將套件解除封裝。 此參數要求在機器上安裝套件的憑證。 如需詳細資訊，請參閱憑證存放區。 |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs |
-vhdSize |
.vhd 或 .vhdx 檔案的所需大小 (以 MB 為單位)。 必須介於 5 MB 到 2040000 MB 之間。 僅適用於 .vhd 或 .vhdx 檔案。 需要 -create 和 -filetype 參數。 |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -create -fileType VHDX -vhdSize 500 |
-MountImage
裝載 VHD、VHDX 或 CIM 映像。 您也需要指定下列必要的子參數：
| 必要的 參數 | 描述 |
|---|---|
-fileType |
要將套件解除封裝的檔案類型。 有效的檔案類型包括 VHD、VHDX、CIM。 |
-imagePath |
所要裝載映像檔的路徑。 |
-MountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>
以下是使用 -MountImage 參數的範例：
msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -fileType CIM
以下是您可以搭配 -MountImage 參數使用的選擇性參數：
| 選擇性參數 | 描述 | 範例 |
|---|---|---|
-readOnly |
布林值 (true 或 false) 指出是否應將映像裝載為唯讀。 如果未指定，映像預設會裝載為唯讀。 | msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false |
-UnmountImage
卸載 VHD、VHDX 或 CIM 映像。 您也需要指定下列必要的子參數：
| 必要的 參數 | 描述 |
|---|---|
-fileType |
要將套件解除封裝的檔案類型。 有效的檔案類型包括 VHD、VHDX、CIM。 |
-imagePath |
所要裝載映像檔的路徑。 |
-UnmountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>
以下是使用 -UnmountImage 參數的範例：
msixmgr.exe -UnmountImage -imagePath "C:\MSIX\myapp.vhdx" -fileType VHDX
以下是您可以搭配 -UnmountImage 參數使用的選擇性參數：
| 選擇性參數 | 描述 | 範例 |
|---|---|---|
-volumeId |
與所要卸除映像相關聯磁碟區的 GUID (不使用大括弧指定)。 此參數僅適用於 CIM 檔案。 您可以執行 PowerShell Cmdlet Get-Volume 來尋找磁碟區識別碼。 | msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM |
-quietUX
在執行 MSIXMGR 工具時隱藏使用者互動。 此參數是選擇性的，可與任何其他參數搭配使用。
以下是搭配 -AddPackage 參數使用 -quietUX 參數的範例：
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX
下一步
若要深入了解 MSIX 應用程式連結，請參閱下列文章：