MSIXMGR 工具参数

本文包含可用于 MSIXMGR 工具的命令行参数和语法。

先决条件

若要使用 MSIXMGR 工具,需要:

  • 下载 MSIXMGR 工具
  • 获取 MSIX 打包的应用程序(.msix 文件)。
  • 具有管理权限的 Windows 设备,用于创建 MSIX 映像。

-AddPackage

在指定的文件路径处添加包。

-AddPackage <Path to the MSIX package>

or

-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 将包解压缩后的文件类型。 有效文件类型包括 VHDVHDXCIM。 解压到 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 将包解压缩后的文件类型。 有效文件类型包括 VHDVHDXCIM
-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 将包解压缩后的文件类型。 有效文件类型包括 VHDVHDXCIM
-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 来查找卷 ID。 msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM

-quietUX

在运行 MSIXMGR 工具时禁止用户交互。 此参数为可选项,可用于任何其他参数。

以下是将 -quietUX 参数与 -AddPackage 参数一起使用的示例:

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

后续步骤

要了解有关 MSIX 应用附加的详细信息,请查看以下文章: