MSIXMGR 工具參數

本文包含你可以使用 MSIXMGR 工具的命令列參數和語法。

必要條件

要使用 MSIXMGR 工具，你需要：

  • 下載 MSIXMGR 工具。
  • 取得一個 MSIX 套件的應用程式 (.msix 檔案) 。
  • 一台具有管理權限以建立 MSIX 映像的 Windows 裝置。

-AddPackage

在指定的檔案路徑上新增套件。

-AddPackage <Path to the MSIX package>

或

-p <Path to the MSIX package>

以下是使用參數 -AddPackage 的範例：

msixmgr.exe -AddPackage "C:\MSIX\myapp.msix"

-移除套件

移除帶有指定全名的套件。

-RemovePackage <Package name>

或

-x <Package name>

這裡有一個使用參數 -RemovePackage 的例子。 你可以透過執行 PowerShell 指令檔 Get-AppxPackage 找到套件的全名。

msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-FindPackage

找一個有特定包裹全名的包裹。

-FindPackage <Package name>

這裡有一個使用參數 -FindPackage 的例子。 你可以透過執行 PowerShell 指令檔 Get-AppxPackage 找到套件的全名。

msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

- 套用ACLs

將 ACL 套用到 package 資料夾 (解壓套件) 。 你還需要指定以下必要的子參數：

必要參數 描述
-packagePath 要解包的套件路徑，或是包含多個套件的目錄路徑 
-ApplyACLs -packagePath <Path to the package folder>

以下是使用參數 -ApplyACLs 的範例：

msixmgr.exe -ApplyACLs -packagePath "C:\MSIX\myapp_0.0.0.1_x64__8wekyb3d8bbwe"

-拆包

解 .appx壓一個套件，採用 、 .msix、 .appxbundle或 .msixbundle，並解壓其內容到資料夾中。 你還需要指定以下必要的子參數：

必要參數 描述
-destination 放置產生的套件資料夾目錄 (s) 。
-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、VHDXCIM。 解包為 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、VHDXCIM。
-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 布林值 (對顯示圖片是否應該掛載為唯讀的假) 成立。 若未指定，映像檔預設為唯讀掛載。 msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false

-UnmountImage

卸載VHD、VHDX或CIM映像檔。 你還需要指定以下必要的子參數：

必要參數 描述
-fileType 解包的檔案類型。 有效的檔案類型包括、VHD、VHDXCIM。
-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 指令檔 Get-Volume 來找到磁碟區 ID。 msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM

-quietUX

在執行 MSIXMGR 工具時，抑制使用者互動。 此參數為可選，且可與其他參數搭配使用。

這裡有一個使用 -quietUX 參數與參數 -AddPackage 的例子：

msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX

後續步驟

想了解更多關於 App Attach 的資訊，請參考以下文章：

  • 上次更新時間：