你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
本文包含可用于 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
删除具有指定包全名的包。
-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"
-解压
将包解包为文件格式之 .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 |
或 .vhdx 文件的所需大小.vhd (以 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 |
(false 的布尔值) true,指示映像是否应装载为只读。 如果未指定,则默认情况下,映像装载为只读。 | 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 来查找卷 ID。 | msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM |
-quietUX
运行 MSIXMGR 工具时禁止用户交互。 此参数是可选的,可与任何其他参数一起使用。
下面是将 参数与 参数配合使用-quietUX
-AddPackage
的示例:
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX
后续步骤
若要了解有关应用附加的详细信息,检查以下文章: