Paramètres de l’outil MSIXMGR

Article
03/11/2024

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>

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

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

Partager via