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 :
- Créer une image MSIX à utiliser avec l’attachement d’application
- Nouveautés de l’outil MSIXMGR
- Attachement d’application et attachement d’application MSIX
- Ajouter et gérer l’attachement d’application et les applications d’attachement d’application MSIX
- Tester des packages MSIX pour l’attachement d’application
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour