Options de Command-Line maintenance de package d’application DISM (. AppX ou. appxbundle)

vous pouvez utiliser des commandes de maintenance de package d’application pour ajouter, supprimer et répertorier des packages d’application approvisionnés (. appx ou. appxbundle) dans une image Windows. Un. appxbundle est une collection de packages d’applications et de ressources utilisés ensemble pour enrichir l’expérience de l’application, tout en minimisant l’encombrement du disque sur un PC donné. pour plus d’informations sur les packages. appxbundle et le pipeline de Microsoft Store, consultez empaquetage d’applications. Seul un sous-ensemble des packages au sein d’un. appxbundle peut être ajouté à l’image lorsqu’un bundle est approvisionné à l’aide de DISM. Pour plus d’informations, consultez comprendre comment DISM ajoute des packages de ressources. appxbundle à une image.

les packages d’application approvisionnés sont ajoutés à une image Windows, puis installés pour chaque profil utilisateur nouveau ou existant à la prochaine ouverture de session de l’utilisateur. Pour plus d’informations, notamment sur la configuration requise pour l’approvisionnement de packages d’application, consultez applications chargement avec DISM.

vous pouvez également utiliser PowerShell pour ajouter, supprimer et répertorier des packages d’application (. appx ou. appxbundle) par image ou par utilisateur dans une installation Windows. pour plus d’informations, consultez applets de commande de gestion de la maintenance des images de déploiement (DISM) dans Windows PowerShell et applets de commande d’Installation d’application dans Windows PowerShell.

Syntaxe de maintenance DISM

la syntaxe de base pour la maintenance d’une image Windows à l’aide de DISM est la suivante :

DISM.exe {/Image:<path_to_image_directory>|/Online} [dism_global_options] {servicing_option} <servicing_argument>]

Options pour les images hors connexion

Les options de maintenance de package d’application (. AppX ou. appxbundle) suivantes sont disponibles pour une image hors connexion.

DISM.exe /Image:<path_to_image_directory> [/Get-ProvisionedAppxPackages | /Add-ProvisionedAppxPackage | /Remove-ProvisionedAppxPackage | /Set-ProvisionedAppxDataFile | /StubPackageOption]

Options pour les images en ligne

Les options de maintenance de package d’application (. AppX ou. appxbundle) suivantes sont disponibles pour un système d’exploitation en cours d’exécution.

DISM.exe /Online [/Get-ProvisionedAppxPackages | /Add-ProvisionedAppxPackage | /Remove-ProvisionedAppxPackage | /Set-ProvisionedAppxDataFile | /StubPackageOption]

/Get-Help /?

Lorsqu’il est utilisé juste après une option de ligne de commande de maintenance des packages d’application, des informations sur l’option et les arguments s’affichent. Des rubriques supplémentaires peuvent devenir disponibles lorsqu’une image est spécifiée.

Dism /image:C:\test\offline /Add-ProvisionedAppxPackage /?
Dism /online /Get-ProvisionedAppxPackages /?

/Get-ProvisionedAppxPackages

Affiche des informations sur les packages d’application (. AppX ou. appxbundle), dans une image, qui sont configurés pour s’installer pour chaque nouvel utilisateur.

Dism /Image:C:\test\offline /Get-ProvisionedAppxPackages

/Add-ProvisionedAppxPackage

Ajoute un ou plusieurs packages d’application à l’image.

l’application sera ajoutée à l’image Windows et inscrite pour chaque profil utilisateur existant ou nouveau la prochaine fois que l’utilisateur se connectera. Si l’application est ajoutée à une image en ligne, l’application n’est pas inscrite pour l’utilisateur actuel jusqu’à la prochaine connexion de l’utilisateur.

Approvisionnez des applications sur un système d’exploitation en ligne en mode audit afin de créer des liens physiques appropriés pour les applications qui contiennent exactement les mêmes fichiers (pour réduire l’utilisation de l’espace disque) tout en veillant à ce qu’aucune application ne s’exécute pour une installation réussie.

Syntaxe :

dism.exe /Add-ProvisionedAppxPackage {/FolderPath:<App_folder_path> [/SkipLicense\] [/CustomDataPath:<custom_file_path>]  /PackagePath:<main_package_path> [/DependencyPackagePath:<dependency_package_path>] {[/LicenseFile:<license_file_path>] [/SkipLicense\]} [/CustomDataPath:<custom_file_path>]} [/Region:<region>]
  • Utilisez /FolderPath pour spécifier un dossier de fichiers d’application décompressés contenant un package principal, tous les packages de dépendances et le fichier de licence. Cela est uniquement pris en charge pour un package d’application décompressé.

  • Utilisez /PackagePath pour spécifier un package d’application (. AppX ou. appxbundle). Vous pouvez utiliser /PackagePath lors de la configuration d’une application métier en ligne.

  • Important: utilisez le /PackagePath paramètre pour approvisionner des packages. appxbundle. En outre, les packages de dépendances ne peuvent pas être approvisionnés avec /PackagePath , ils doivent être approvisionnés avec le /DependencyPackagePath paramètre pour une application.

  • /PackagePathn’est pas pris en charge à partir d’un ordinateur hôte exécutant environnement de préinstallation Windows (WinPE) (WinPE) 4,0, Windows Server 2008 R2 ou une version antérieure de Windows.

  • Utilisez /Region pour spécifier les régions dans lesquelles un package d’application (. AppX ou. appxbundle) doit être approvisionné. L’argument Region peut être :

    • all, indiquant que l’application doit être approvisionnée pour toutes les régions, ou
    • Liste de régions délimitée par des points-virgules. Les régions se présenteront sous la forme de codes iso 3166-1 alpha-2 ou iso 3166-1 alpha-3. Par exemple, le États-Unis peut être spécifié comme « US » ou « USA » (non-respect de la casse). Lorsqu’une liste de régions n’est pas spécifiée, le package est approvisionné uniquement s’il est épinglé à la disposition de démarrage.
    • Utilisez /DependencyPackagePath pour spécifier chaque package dépendances nécessaire à la configuration de l’application. Vous pouvez trouver les packages de dépendances d’une application en examinant les <PackageDependency> éléments de la AppxManifest.xml à la racine du package. AppX de l’application. Si plusieurs applications partagent toutes la même dépendance, la dernière version mineure de chaque version majeure du package de dépendances doit être installée. Par exemple, App1, App2 et App3 ont tous une dépendance sur Microsoft. NET. native. Framework. App1 spécifie Microsoft. NET. native. Framework. 1.6 avec la version mineure 25512,0, App2 spécifie Microsoft. NET. native. Framework. 1.6 avec la version mineure 25513,0, et App3 spécifie Microsoft. NET. native. Framework. 1.3 avec la version mineure 24202,0. Comme App1 et App2 spécifient tous deux la même version principale du package de dépendances, seule la version mineure 25513,0 la plus récente doit être installée, tandis que App3 spécifie une version principale différente du package de dépendance. il doit donc également être installé. Par conséquent, les packages de dépendances qui doivent être installés sont Microsoft. NET. native. Framework. 1.6 avec la version mineure 25513,0 et Microsoft. NET. native. Framework. 1.3 avec la version mineure 24202,0.

    Si le package possède des dépendances spécifiques à l’architecture, vous devez installer toutes les architectures applicables pour la dépendance sur l’image cible. Par exemple, sur une image cible x64, incluez un chemin d’accès aux packages de dépendance x86 et x64, ou incluez-les tous les deux dans le dossier des fichiers d’application décompressés. Si le package de dépendances ARM est également spécifié ou inclus, DISM l’ignore, car il ne s’applique pas à l’image x64 cible.

    Architecture de l’ordinateurDépendances à installer :
    x64x64 et x86
    x86x86
    ARMARM uniquement
  • Utilisez /CustomDataPath pour spécifier un fichier de données personnalisé facultatif pour une application. Vous pouvez spécifier n’importe quel nom de fichier. Le fichier est renommé en Custom. dat lorsqu’il est ajouté à l’image.

  • Utilisez /LicensePath avec l' /PackagePath option pour spécifier l’emplacement du fichier .xml contenant votre licence d’application.

  • Utilisez uniquement /SkipLicense avec les applications qui n’ont pas besoin d’une licence sur un ordinateur compatible avec chargement. L’utilisation /SkipLicense de dans d’autres scénarios peut compromettre une image.

Exemples :

Dism /Image:C:\test\offline /Add-ProvisionedAppxPackage /FolderPath:c:\Test\Apps\MyUnpackedApp /CustomDataPath:c:\Test\Apps\CustomData.xml
Dism /Online /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appx /DependencyPackagePath:C:\Test\Apps\MyPackedApp\Framework-x86.appx /DependencyPackagePath:C:\Test\Apps\MyPackedApp\Framework-x64.appx /LicensePath:C:\Test\Apps\MyLicense.xml
Dism /Online /Add-ProvisionedAppxPackage /FolderPath:C:\Test\Apps\MyUnpackedApp /SkipLicense
Dism /Image:C:\test\offline /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appxbundle /SkipLicense
Dism /Online /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appxbundle /Region:"all"
Dism /Online /Add-ProvisionedAppxPackage /PackagePath:C:\Test\Apps\MyPackedApp\MainPackage.appxbundle /Region:"US;GB"

/Remove-ProvisionedAppxPackage

Supprime l’approvisionnement pour les packages d’application (. AppX ou. appxbundle) de l’image. Les packages d’application ne seront pas inscrits auprès des nouveaux comptes d’utilisateur créés.

Syntaxe :

/Remove-ProvisionedAppxPackage /PackageName:<PackageName>

Important

Cette option supprime uniquement l’approvisionnement d’un package s’il est inscrit auprès d’un profil utilisateur. Utilisez l’applet de commande Remove-AppxPackage dans PowerShell pour supprimer l’application pour chaque utilisateur auquel elle est déjà inscrite afin de supprimer complètement l’application de l’image. Si l’application n’a pas été inscrite auprès d’un profil utilisateur, l' /Remove-ProvisionedAppxPackage option supprimera complètement le package. pour supprimer des packages d’application d’une Windows Server 2012 ou version ultérieure, une image sur laquelle l’expérience de bureau est installée, vous devez supprimer les packages d’application avant de supprimer l’expérience utilisateur. l’expérience utilisateur est une exigence de l' /Remove-ProvisionedAppxPackage option pour les installations minimales de Windows server.

Exemple :

Dism /Image:C:\test\offline /Remove-ProvisionedAppxPackage /PackageName:microsoft.devx.appx.app1_1.0.0.0_neutral_ac4zc6fex2zjp

/Optimize-ProvisionedAppxPackages

Optimise la taille totale du fichier des packages approvisionnés sur l’image en remplaçant des fichiers identiques par liaisons permanentes. Une fois qu’une image avec des packages AppX approvisionnés est en ligne, /optimize-provisionedappxpackages ne peut pas optimiser les packages AppX approvisionnés. Si vous prenez une image hors connexion et que vous ajoutez des packages, seuls les packages qui sont approvisionnés après la remise hors connexion de l’image sont optimisés.

Cette commande n’est pas prise en charge pour une image en ligne.

DISM.exe /Image:C:\test\offline /Optimize-ProvisionedAppxPackages

/Set-ProvisionedAppxDataFile

Ajoute un fichier de données personnalisé dans le package d’application spécifié (. AppX ou. appxbundle).

Syntaxe

/Set-ProvisionedAppxDataFile [/CustomDataPath<custom_file_path>] /PackageName<PackageName>

Le package d’application (. AppX ou. appxbundle) spécifié doit déjà être ajouté à l’image avant que vous ajoutiez le fichier de données personnalisé avec cette option. Vous pouvez également ajouter un fichier de données personnalisé lorsque vous utilisez l' /Add-ProvisionedAppxPackage option.

  • Utilisez /CustomDataPath pour spécifier un fichier de données personnalisé facultatif pour une application. Vous pouvez spécifier n’importe quel nom de fichier. Le fichier est renommé en Custom. dat lorsqu’il est ajouté à l’image. Si un fichier. dat personnalisé existe déjà, il sera remplacé.

  • Utilisez /PackageName pour spécifier un package d’application (. AppX ou. appxbundle).

Exemple :

DISM.exe /Image:C:\test\offline /Set-ProvisionedAppxDataFile /CustomDataPath:c:\Test\Apps\Custom.dat /PackageName:microsoft.appx.app1_1.0.0.0_neutral_ac4zc6fex2zjp

/StubPackageOption

Utilisé conjointement avec les options de maintenance de package d’application pour spécifier la préférence de stub du package.

Syntaxe :

/StubPackageOption:{installstub | installfull}
  • InstallStub définit le package d’approvisionnement sur la version stub. Définit implicitement la préférence stub sur stub.
  • InstallFull définit le package de configuration sur approvisionner la version complète. Définit implicitement la préférence stub sur Full.

Si aucune option de package stub n’est spécifiée, la version du package approvisionné est définie sur les préférences de stub prédéfinies.

Exemple :

Dism /image:C:\test\offline /add-provisionedappxpackage /packagepath:"C:\dism\stub\appwithresources.appxbundle" /stubpackageoption:installstub

Comprendre comment DISM ajoute des packages de ressources. appxbundle à une image

Quand un. appxbundle est ajouté à l’image, tous les packages de ressources au sein du regroupement ne sont pas applicables. par exemple, si une application est ajoutée à une image Windows avec une langue par défaut espagnole (espagne), les ressources françaises (France) ne doivent pas être incluses. Pour déterminer quelles ressources sont ajoutées à l’image, l’applicabilité du package est déterminée à l’aide de :

  • Packs de ressources linguistiques: si une langue du système d’exploitation n’est pas présente, le Pack de ressources App Language correspondant n’est pas ajouté. par exemple, vous pouvez avoir une image qui est une Windows 10 avec l’anglais (états-unis) comme langue par défaut et un module linguistique espagnol (espagne) inclus. Les packs de ressources d’application en anglais (États-Unis) et espagnol (Espagne) seront ajoutés à l’image. Si un pack de ressources français (France) (ou toute autre langue) est disponible dans le bundle d’applications, il ne sera pas ajouté.

  • les packs de ressources scale et directx (DXFL): les packs de ressources scale et directx (DXFL) dépendent de la configuration matérielle de l’appareil Windows. Étant donné que le type de matériel cible ne peut pas être connu au moment de l’exécution des commandes DISM, tous les packages de ressources Scale et DXFL sont ajoutés à l’image au moment de l’approvisionnement. pour plus d’informations sur le développement d’une application avec des ressources de mise à l’échelle, consultez instructions pour la mise à l’échelle vers la densité de pixels (applications Microsoft Store).

Pour une image contenant plusieurs modules linguistiques, des packages de ressources d’application sont ajoutés à l’image pour chaque langue. Une fois que le premier utilisateur s’est connecté au PC avec l’image déployée et que l’utilisateur a choisi une langue au cours de l’OOBE, les packages de ressources inapplicables, (modules des ressources linguistiques, mettre à l’échelle les packs de ressources et packages de ressources DXFL) qui ne correspondent pas aux paramètres du profil utilisateur sont supprimés.

Par exemple, une application peut prendre en charge les langues anglaise (US), français (France) et espagnol (Espagne). Si l’application est ajoutée à une image dont les modules linguistiques Anglais (US) et espagnol (Espagne) sont présents, seuls les packs de ressources anglais (US) et espagnol (Espagne) seront ajoutés à l’image. Ensuite, si un utilisateur se connecte pour la première fois et, pendant l’OOBE, sélectionne anglais (US) comme langue du système d’exploitation, les packages de ressources espagnol (Espagne) seront supprimés une fois la connexion terminée.

Important

Si vous ajoutez ou supprimez un module linguistique d’une image, vous modifiez le contexte de mise en application, ce qui peut entraîner la sortie d’un ensemble incorrect ou incomplet de packages de ressources dans l’image. quand un module linguistique est ajouté ou supprimé, vous devez à nouveau ajouter tous les packages. appxbundle (y compris tous les packages de dépendances et Microsoft Store fichier de licence) à l’image. Cela permet de s’assurer que l’ensemble correct de packages de ressources est approvisionné.

Limites

  • vous ne pouvez pas installer un package d’application (. appx) sur un système d’exploitation qui ne prend pas en charge les applications Windows 8. vous ne pouvez pas installer un package d’application (. appxbundle) sur un système d’exploitation qui ne prend pas en charge au moins Windows 8.1 applications. les applications ne sont pas prises en charge sur WinPE 4,0, l’option d’installation minimale Windows Server 2012 Server ou sur les versions de Windows antérieures à Windows 8 et Windows Server 2012.

    pour installer et exécuter des applications sur Windows Server 2012, vous devez installer l' expérience utilisateur.

  • L’option /folderPath est uniquement prise en charge pour les packages d’application basés sur le format. Appx.

  • /PackagePath doit toujours être utilisé pour les packages. appxbundle.

Qu’est-ce que DISM ?

Options de Command-Line de gestion des images DISM

Options de gestion et maintenance des images de déploiement (DISM) Command-Line

Charger indépendamment des applications avec DISM