Parámetros de la herramienta MSIXMGR

Artículo
03/06/2024

Este artículo contiene los parámetros de línea de comandos y la sintaxis que puede usar con la herramienta MSIXMGR.

Requisitos previos

Para usar la herramienta MSIXMGR, debe hacer lo siguiente:

Descargar la herramienta MSIXMGR.
Obtener una aplicación empaquetada con MSIX (archivo .msix).
Tener un dispositivo Windows con permisos administrativos para crear la imagen MSIX.

-AddPackage

Agregue el paquete en la ruta de acceso del archivo especificada.

-AddPackage <Path to the MSIX package>

-p <Path to the MSIX package>

Este es un ejemplo del uso del parámetro -AddPackage:

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

-RemovePackage

Quite el paquete con el nombre completo del paquete especificado.

-RemovePackage <Package name>

-x <Package name>

Este es un ejemplo del uso del parámetro -RemovePackage. Para encontrar el nombre completo del paquete, ejecute el cmdlet de PowerShell Get-AppxPackage.

msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-FindPackage

Busque un paquete con el nombre completo del paquete específico.

-FindPackage <Package name>

Este es un ejemplo del uso del parámetro -FindPackage. Para encontrar el nombre completo del paquete, ejecute el cmdlet de PowerShell Get-AppxPackage.

msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-ApplyACLs

Aplique ACL a una carpeta de paquete (un paquete desempaquetado). También debe especificar los siguientes subparámetros obligatorios:

Parámetro requerido	Descripción
`-packagePath`	La ruta de acceso al paquete que se va a desempaquetar O BIEN la ruta de acceso a un directorio que contiene varios paquetes para desempaquetar

-ApplyACLs -packagePath <Path to the package folder>

Este es un ejemplo del uso del parámetro -ApplyACLs:

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

-Unpack

Desempaquete un paquete en uno de los formatos de archivo .appx, .msix, .appxbundle o .msixbundle, y extraiga su contenido en una carpeta. También debe especificar los siguientes subparámetros obligatorios:

Parámetro requerido	Descripción
`-destination`	Directorio en el que se colocarán las carpetas de paquete resultantes.
`-fileType`	Tipo de archivo en el que se desempaquetan los paquetes. Los tipos de archivo válidos incluyen `.vhd`, `.vhdx`, `.cim`. Es un parámetro necesario solo al desempaquetar en archivos CIM.
`-packagePath`	La ruta de acceso al paquete que se va a desempaquetar O BIEN la ruta de acceso a un directorio que contiene varios paquetes para desempaquetar.
`-rootDirectory`	Especifica el directorio raíz de la imagen en el que se desempaquetan los paquetes. Es un parámetro necesario solo al desempaquetar en archivos CIM nuevos y existentes.

-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>

Estos son algunos ejemplos de uso del parámetro -Unpack:

Para desempaquetar un paquete en un directorio:

msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp"

Para desempaquetar un paquete en una imagen de disco VHDX:

msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.vhdx" -applyACLs -create -filetype VHDX -rootDirectory apps

Para desempaquetar un paquete en una imagen de disco VHDX:

msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.cim" -applyACLs -create -filetype CIM -rootDirectory apps

Estos son los parámetros opcionales que puede usar con el parámetro -Unpack:

Parámetro opcional	Descripción	Ejemplo
`-applyACLs`	Aplica ACL a las carpetas de paquetes resultantes y a su carpeta primaria.	`msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs`
`-create`	Crea una imagen con el tipo de archivo especificado y desempaqueta los paquetes en esa imagen. Requiere el parámetro `-filetype`.	`msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX`
`-fileType`	Tipo de archivo en el que se desempaquetan los paquetes. Los tipos de archivo válidos incluyen `VHD`, `VHDX`, `CIM`. Este parámetro es obligatorio al desempaquetar en archivos CIM. Requiere el parámetro `-create`.	`msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps`
`-rootDirectory`	Especifica el directorio raíz de la imagen en el que se desempaquetan los paquetes. Este parámetro es obligatorio al desempaquetar en archivos CIM nuevos y existentes.	`msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps`
`-validateSignature`	Valida un archivo de firma de paquete antes de desempaquetar el paquete. Para este parámetro es necesario que el certificado del paquete esté instalado en la máquina. Para más información, consulte Almacenes de certificados.	`msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs`
`-vhdSize`	Tamaño deseado del archivo `.vhd` o `.vhdx` en MB. Debe tener un tamaño de entre 5 MB y 2 040 000 MB. Solo se usa para archivos `.vhd` o `.vhdx`. Necesita los parámetros `-create` y `-filetype`.	`msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -create -fileType VHDX -vhdSize 500`

-MountImage

Monte una imagen VHD, VHDX o CIM. También debe especificar los siguientes subparámetros obligatorios:

Parámetro requerido	Descripción
`-fileType`	Tipo de archivo en el que se desempaquetan los paquetes. Los tipos de archivo válidos incluyen `VHD`, `VHDX`, `CIM`.
`-imagePath`	Ruta de acceso al archivo de imagen que se va a montar.

-MountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

Este es un ejemplo del uso del parámetro -MountImage:

msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -fileType CIM

Estos son los parámetros opcionales que puede usar con el parámetro -MountImage:

Parámetro opcional	Descripción	Ejemplo
`-readOnly`	Valor booleano (true o false) que indica si la imagen debe montarse como de solo lectura. Si no se especifica, la imagen se monta como de solo lectura de manera predeterminada.	`msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false`

-UnmountImage

Desmonte una imagen VHD, VHDX o CIM. También debe especificar los siguientes subparámetros obligatorios:

Parámetro requerido	Descripción
`-fileType`	Tipo de archivo en el que se desempaquetan los paquetes. Los tipos de archivo válidos incluyen `VHD`, `VHDX`, `CIM`.
`-imagePath`	Ruta de acceso al archivo de imagen que se va a montar.

-UnmountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

Este es un ejemplo del uso del parámetro -UnmountImage:

msixmgr.exe -UnmountImage -imagePath "C:\MSIX\myapp.vhdx" -fileType VHDX

Estos son los parámetros opcionales que puede usar con el parámetro -UnmountImage:

Parámetro opcional	Descripción	Ejemplo
`-volumeId`	GUID del volumen (especificado sin llaves) asociado a la imagen que se va a desmontar. Es un parámetro opcional solo para los archivos CIM. Para encontrar el identificador de volumen, ejecute el cmdlet de PowerShell Get-Volume.	`msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM`

-quietUX

Suprime la interacción del usuario al ejecutar la herramienta MSIXMGR. Este parámetro es opcional y se puede usar con cualquier otro parámetro.

Este es un ejemplo del uso del parámetro -quietUX con el parámetro-AddPackage:

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

Pasos siguientes

Para más información sobre la asociación de aplicaciones MSIX, consulte estos artículos:

Compartir vía