Partager via


Paramètres de l’outil MSIXMGR

Cet article contient les paramètres de ligne de commande et la syntaxe que vous pouvez utiliser avec l’outil MSIXMGR.

Prérequis

Pour utiliser l’outil MSIXMGR, vous devez :

  • Télécharger l’outil MSIXMGR.
  • Obtenir une application empaquetée MSIX (fichier .msix).
  • Appareil Windows avec les autorisations administratives de création de l’image MSIX.

-AddPackage

Ajoute le package au chemin d’accès spécifié.

-AddPackage <Path to the MSIX package>

or

-p <Path to the MSIX package>

Voici un exemple d’utilisation du paramètre -AddPackage :

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

-RemovePackage

Supprime le package portant le nom complet spécifié.

-RemovePackage <Package name>

or

-x <Package name>

Voici un exemple d’utilisation du paramètre -RemovePackage. Vous trouverez le nom complet du package en exécutant la cmdlet PowerShell Get-AppxPackage.

msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-FindPackage

Recherche un package portant le nom complet spécifié.

-FindPackage <Package name>

Voici un exemple d’utilisation du paramètre -FindPackage. Vous trouverez le nom complet du package en exécutant la cmdlet PowerShell Get-AppxPackage.

msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-ApplyACLs

Appliquez des listes de contrôle d’accès (ACL) à un dossier de package (package décompressé). Vous devez également spécifier les sous-paramètres requis suivants :

Paramètre requis Description
-packagePath Chemin d’accès au package à décompresser OU chemin d’accès à un répertoire contenant plusieurs packages à décompresser
-ApplyACLs -packagePath <Path to the package folder>

Voici un exemple d’utilisation du paramètre -ApplyACLs :

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

-Unpack

Décompressez un package dans l’un des formats de fichier .appx, .msix, .appxbundle ou .msixbundle, puis extrayez son contenu dans un dossier. Vous devez également spécifier les sous-paramètres requis suivants :

Paramètre requis Description
-destination Répertoire dans lequel placer les dossiers de package résultants.
-fileType Type de fichier dans lequel décompresser les packages. Les types de fichiers valides incluent .vhd, .vhdx, .cim. Ce paramètre est obligatoire uniquement lors de la décompression dans des fichiers CIM.
-packagePath Chemin d’accès au package à décompresser OU chemin d’accès à un répertoire contenant plusieurs packages à décompresser.
-rootDirectory Spécifie le répertoire racine sur l’image dans lequel décompresser les packages. Ce paramètre est obligatoire uniquement lors de la décompression dans des fichiers CIM nouveaux et existants.
-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>

Voici quelques exemples d’utilisation du paramètre -Unpack :

  • Pour décompresser un package dans un répertoire :

    msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp"
    
  • Pour décompresser un package dans une image disque VHDX :

    msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.vhdx" -applyACLs -create -filetype VHDX -rootDirectory apps
    
  • Pour décompresser un package dans une image disque CIM :

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

Voici les paramètres facultatifs que vous pouvez utiliser avec le paramètre -Unpack :

Paramètre facultatif : Description Exemple
-applyACLs Applique des listes de contrôle d’accès (ACL) aux dossiers de package résultants et à leur dossier parent. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs
-create Crée une image avec le paramètre de type de fichier spécifié, puis décompresse les packages dans cette image. Nécessite le paramètre -filetype. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX
-fileType Type de fichier dans lequel décompresser les packages. Les types de fichiers valides incluent VHD, VHDX, CIM. Ce paramètre est obligatoire lors de la décompression dans des fichiers CIM. Nécessite le paramètre -create. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps
-rootDirectory Spécifie le répertoire racine sur l’image dans lequel décompresser les packages. Ce paramètre est obligatoire lors de la décompression dans des fichiers CIM nouveaux et existants. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps
-validateSignature Valide le fichier de signature d’un package avant sa décompression. Ce paramètre nécessite l’installation du certificat du package sur la machine.

Pour plus d’informations, consultez l’article Magasins de certificats.
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs
-vhdSize Taille souhaitée du fichier .vhd ou .vhdx en Mo. Ce chiffre doit être compris entre 5 Mo et 2 040 000 Mo. À utiliser uniquement pour les fichiers .vhd ou .vhdx. Nécessite les paramètres -create et -filetype. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -create -fileType VHDX -vhdSize 500

-MountImage

Montez une image VHD, VHDX ou CIM. Vous devez également spécifier les sous-paramètres requis suivants :

Paramètre requis Description
-fileType Type de fichier dans lequel décompresser les packages. Les types de fichiers valides incluent VHD, VHDX, CIM.
-imagePath Chemin d’accès au fichier image à monter.
-MountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

Voici un exemple d’utilisation du paramètre -MountImage :

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

Voici les paramètres facultatifs que vous pouvez utiliser avec le paramètre -MountImage :

Paramètre facultatif : Description Exemple
-readOnly Valeur booléenne (true ou false) indiquant si l’image doit être montée en lecture seule. Si ce paramètre n’est pas spécifié, l’image est montée en lecture seule par défaut. msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false

-UnmountImage

Démontez une image VHD, VHDX ou CIM. Vous devez également spécifier les sous-paramètres requis suivants :

Paramètre requis Description
-fileType Type de fichier dans lequel décompresser les packages. Les types de fichiers valides incluent VHD, VHDX, CIM.
-imagePath Chemin d’accès au fichier image à monter.
-UnmountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

Voici un exemple d’utilisation du paramètre -UnmountImage :

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

Voici les paramètres facultatifs que vous pouvez utiliser avec le paramètre -UnmountImage :

Paramètre facultatif : Description Exemple
-volumeId Spécifie le GUID du volume (sans accolades) associé à l’image à démonter. Ce paramètre est facultatif uniquement pour les fichiers CIM. Vous trouverez l’ID de volume en exécutant la cmdlet PowerShell Get-Volume. msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM

-quietUX

Supprime l’interaction utilisateur lors de l’exécution de l’outil MSIXMGR. Ce paramètre est facultatif et peut être utilisé avec tous les autres paramètres.

Voici un exemple d’utilisation du paramètre -quietUX avec le paramètre -AddPackage :

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

Étapes suivantes

Pour en savoir plus sur l’attachement d’application MSIX, consultez les articles suivants :