Parámetros de la herramienta MSIXMGR

  • Artículo

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>

o

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

o

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