Préinstaller des applications à l’aide de DISM

Article
06/19/2023

Notes

Vous souhaitez préinstaller des applications du Microsoft Store, mais vous n’êtes pas oem ? Pour plus d’informations sur le chargement indépendant d’applications pour les organisations, consultez Chargement indépendant d’applications avec DISM.

Cette rubrique explique comment préinstaller des applications afin qu’elles soient incluses dans une image Windows.

Conseil

Les applications de support matériel (HSA) sont des applications du Microsoft Store, et les instructions suivantes s’appliquent.

Utiliser des packages d’application

Utilisez DISM pour provisionner hors connexion une application dans une image. Vous pouvez utiliser DISM à partir de l’invite de commandes ou des applets de commande DISM dans Windows PowerShell.

Dans les versions précédentes de Windows 10, les applications universelles préinstallées et les applications du Microsoft Store devaient être épinglées au menu Démarrer. Windows supprime les applications qui ont été préinstallées mais qui n’ont pas été épinglées au menu Démarrer.

À compter de Windows 10 version 1803, les applications peuvent être préinstallées sans être épinglées au menu Démarrer lorsque vous utilisez DISM /add-provisionedappxpackage l’option /region . Lorsque vous préinstallez une application, vous pouvez choisir de laisser l’application hors de votre LayoutModification.xml et l’application s’installera correctement sans apparaître sous la forme d’une vignette du menu Démarrer. Lorsqu’une liste de régions n’est PAS spécifiée, l’application est provisionnée uniquement si elle est épinglée pour démarrer la disposition.

Extraire les fichiers de package

Accédez au dossier dans lequel vous avez enregistré les packages d’application que vous avez téléchargés à partir du tableau de bord du partenaire.
Cliquez avec le bouton droit sur chaque dossier .zip contenant vos fichiers de package d’application. Cliquez sur Extraire tout et sélectionnez un emplacement pour enregistrer les dossiers de fichiers de package.

Le dossier contient tous les fichiers décompressés pour le package, y compris un package main, tous les packages de dépendances et le fichier de licence.

Important

Ne modifiez pas le dossier une fois que vous avez extrait les fichiers de package. Si vous modifiez, ajoutez ou supprimez des fichiers dans le dossier, l’application échoue lors de l’installation ou du lancement. Même la navigation dans le dossier peut entraîner des problèmes.

Vous devez utiliser le fichier de licence des fichiers de package pour tester votre image provisionnée. La création de votre propre fichier de données personnalisé ne vous permet pas de tester avec précision une application préinstallée par un OEM.

Pour l’approvisionnement hors connexion d’une application dans une image, vous pouvez utiliser l’outil Dism.exe ou les applets de commande DISM dans Windows PowerShell pour ajouter une application à partir d’un dossier de fichiers décompressés.

Préinstaller une application signée par le Microsoft Store avec DISM

Ouvrez l’invite de commandes en tant qu’administrateur.

Montez une image Windows pour laquelle vous souhaitez traiter :

Dism /Mount-Image /ImageFile:c:\images\myimage.wim /Index:1 /mountdir:c:\test\offline

Ajoutez l’application à l’image montée. Utilisez les /PackagePath options et /DependencyPackagePath .
- Packagepath est le chemin d’accès au fichier groupé ou package .appx
- DependencyPackagePath est le chemin d’accès permettant de spécifier chaque package de dépendances. Vous pouvez avoir plusieurs dépendances par commande.
- Nouveauté de Windows 10, version 1803 : utilisez l’option lors de l’ajout Region d’applications. Region vous permet d’ajouter une application sans avoir à épingler l’application au menu Démarrer.
```
Dism /Image:c:\test\offline /Add-ProvisionedAppxPackage /PackagePath:c:\downloads\package.appxbundle /DependencyPackagePath:c:\downloads\dependency1.appx /DependencyPackagePath:c:\downloads\dependency2.appx /LicensePath=c:\downloads\package_License1.xml /region=all"
```
Pour plus d’informations sur l’utilisation des packages d’application, notamment la nouvelle option /region, consultez Options de ligne de commande de maintenance des packages d’application DISM .
Épinglez l’application au menu Démarrer.
- Si vous n’avez pas spécifié /region lors de la préinstallation de l’application, épinglez l’application au menu Démarrer avec LayoutModification.xml.
  
  or
- Si vous avez spécifié /region lors de la préinstallation de l’application et que vous souhaitez épingler l’application au menu Démarrer pour des régions spécifiques, utilisez l’élémentRequiredStartGroups Region="region1|region2" dans LayoutModification.xml pour spécifier les régions où vous souhaitez que l’application apparaisse.
Enregistrez les modifications et démontez l’image. À l’invite de commandes, tapez :
```
Dism /Unmount-Image /mountdir:c:\test\offline /commit
```

Notes

Les applications du Microsoft Store ne s’exécutent pas en mode audit. Pour tester votre déploiement, exécutez Windows et créez un profil utilisateur. Pour plus d’informations sur le mode audit, consultez Vue d’ensemble du mode d’audit.

Important Si vous préinstallez une application d’appareil haut débit mobile, vous devez insérer la carte SIM dans le PC avant d’exécuter la phase de spécialisation de Sysprep. Pour plus d’informations sur la préinstallation d’une application d’appareil haut débit mobile, consultez Préinstaller les composants nécessaires pour une expérience d’application haut débit mobile.

Mettre à jour ou supprimer des packages

Vous pouvez supprimer une application préinstallée, y compris les fichiers de données personnalisés et de licence, d’une image Windows à l’aide de l’outil DISM.exe ou des applets de commande DISM dans Windows PowerShell. Vous devez supprimer l’ancienne version de l’application avant d’en installer une nouvelle.

Supprimer une application préinstallée à l’aide de DISM

Ouvrez l’invite de commandes Outils de déploiement, installée avec Windows ADK, avec des privilèges d’administrateur. Dans l’écran d’accueil, tapez Deployment and Imaging Tools Environment, cliquez avec le bouton droit sur l’icône, puis sélectionnez Exécuter en tant qu’administrateur.
Montez l’image hors connexion à des fins de maintenance. À l’invite de commandes, tapez :
```
Dism /Mount-Image /ImageFile:c:\images\myimage.wim /Index:1 /mountdir:c:\test\offline
```
Recherchez le nom complet du package de l’application que vous souhaitez supprimer. À l’invite de commandes, tapez :
```
Dism /Image:C:\test\offline /Get-ProvisionedAppxPackages
```

Supprimez l’application de l’image montée. Par exemple, à l'invite de commandes, tapez :

Dism /Image:c:\test\offline /Remove-ProvisionedAppxPackage /PackageName:microsoft.devx.appx.app1_1.0.0.0_neutral_en-us_ac4zc6fex2zjp

Si vous souhaitez mettre à jour l’application, vous pouvez préinstaller la version mise à jour de l’application signée par le Microsoft Store. À l’invite de commandes, tapez :
```
Dism /Image:c:\test\offline /Add-ProvisionedAppxPackage/FolderPath:c:\downloads\appxpackage
```
Enregistrez les modifications et démontez l’image. À l’invite de commandes, tapez :
```
Dism /Unmount-Image /mountdir:c:\test\offline /commit
```

Utiliser des fichiers de données personnalisés

Les applications préinstallées sur un PC peuvent accéder à des données personnalisées spécifiques à l’installation. Ces données personnalisées sont ajoutées à l’application lors de la préinstallation et sont disponibles au moment de l’exécution. Les données personnalisées permettent aux développeurs de personnaliser les fonctionnalités d’une application, notamment en fournissant des fonctionnalités de création de rapports.

Ajouter un fichier de données personnalisé à une image Windows

Vous devez spécifier le fichier de données personnalisé lorsque vous préinstallez l’application à l’aide de l’outil DISM et via Windows PowerShell à l’aide de l’applet de commande Add-AppxProvisionedPackage. La commande suivante montre comment procéder à l’aide de l’outil DISM :

Dism /Image:C:\test\offline /Add-ProvisionedAppxPackage / FolderPath:f:\Apps\Fabrikam_KnowMyPC /CustomDataPath:f:\Contoso_Promotion.xml

Si un fichier de données personnalisé existe déjà dans le magasin de données d’une application( par exemple, si le package a déjà été ajouté à l’image), le fichier existant est remplacé. Si l’installation échoue, le fichier n’est pas restauré.

Note Vous pouvez publier des mises à jour d’une application via le Microsoft Store sans perdre le fichier de données personnalisé. Toutefois, si un utilisateur supprime l’application, le fichier de données personnalisé n’est plus disponible, même si l’utilisateur réinstalle l’application.

Tester des données personnalisées pour les applications préinstallées

Les applications préinstallées sur un PC peuvent accéder à des données personnalisées spécifiques à l’installation. Ces données personnalisées sont ajoutées à l’application lors de la préinstallation et sont disponibles pour l’application au moment de l’exécution. Les données personnalisées permettent aux développeurs de personnaliser les fonctionnalités d’une application, notamment en fournissant des fonctionnalités de création de rapports.

Le fichier Custom.data apparaît à l’emplacement installé de l’application. Le nom Custom.data est codé en dur et ne peut pas être modifié. Votre application peut case activée l’existence de ce fichier pour déterminer si l’application a été préinstallée sur le PC. Voici un exemple d’accès au fichier Custom.data.

var outputDiv = document.getElementById("CustomData");
Windows.ApplicationModel.Package.current.installedLocation.getFileAsync
     ("microsoft.system.package.metadata\\Custom.data").then(function (file) {
         // Read the file
         Windows.Storage.FileIO.readTextAsync(file).done(function (fileContent) {
            outputDiv.innerHTML = 
                 "App is preinstalled. CustomData contains:<br /><br />"
                 + fileContent;
         },
         function (error) {
             outputDiv.innerText = "Error reading CustomData " + error;
         });
     },
     function (error) {
         outputDiv.innerText = "CustomData was not available. App not preinstalled";
     });

Votre fichier Custom.data peut inclure n’importe quel contenu et être dans n’importe quel format requis par votre application. Le processus de préinstallation le rend simplement disponible pour votre application. Les développeurs peuvent fournir le fichier de données au partenaire de préinstallation, ou vous pouvez accepter un format qui permet au partenaire de générer le contenu.

Tester vos données personnalisées

Lorsque vous générez et déboguez votre application dans Microsoft Visual Studio, vous ne pouvez pas accéder au fichier Custom.data à partir de l’emplacement d’installation de l’application, car l’application n’est pas encore préinstallée. Vous pouvez simuler l’utilisation de votre fichier Custom.data en plaçant un fichier Custom.data de test dans l’application elle-même, puis en chargeant et en testant le fichier local de l’application. Pour ce faire, modifiez l’exemple de code à partir de :

("microsoft.system.package.metadata\\Custom.data").then(function (file) {

à :

("Custom.data").then(function (file) {

Après avoir vérifié le format et le contenu de votre fichier, vous pouvez remplacer l’emplacement du fichier Custom.data par l’emplacement final, comme indiqué dans l’exemple d’origine ci-dessus.

Pour tester votre fichier Custom.data

Ouvrez l’invite de commandes Outils de déploiement, installée avec Windows ADK, avec des privilèges d’administrateur. Dans l’écran d’accueil, tapez Deployment and Imaging Tools Environment, cliquez avec le bouton droit sur l’icône, puis sélectionnez Exécuter en tant qu’administrateur.
Ajoutez l’application avec le fichier de données personnalisé :
```
dism /online /Add-ProvisionedAppxPackage /PackagePath:.\CustomData_1.0.0.1_AnyCPU_Debug.appx /CustomDataPath:.\Test.txt /SkipLicense
```
Où /PackagePath:.\CustomData_1.0.0.1_AnyCPU_Debug.appx pointe vers votre package de test d’application local et où /CustomDataPath:.\Test.txt pointe vers votre fichier Custom.data. N’oubliez pas que le nom de fichier que vous fournissez ici n’est pas utilisé une fois les données installées dans votre application.

L’application a maintenant une vignette sur l’écran d’accueil du PC utilisé pour tester l’application. L’application doit être en mesure d’accéder au fichier Custom.data. Si un débogage supplémentaire est nécessaire, attachez un débogueur après avoir démarré l’application à partir de l’écran d’accueil .

Note Vous devrez peut-être vous déconnecter et vous reconnecter pour voir l’application sur l’écran d’accueil .
Une fois que vous avez terminé de tester votre application, vous devez supprimer le package préinstallé pour continuer à utiliser votre environnement de développement. Pour supprimer le package préinstallé à l’aide de Windows PowerShell, vous pouvez utiliser l’applet de commande Get-AppxPackage pour fournir le nom complet du package d’application via le pipeline à l’applet de commande Remove-ProvisionedAppxPackage :

Get-AppxPackage *CustomData* | Remove-ProvisionedAppxPackage

Où *CustomData* est la partie connue du nom de votre application

Préinstaller une application d’appareil du Microsoft Store ou une application haut débit mobile

Vous pouvez préinstaller les composants nécessaires pour une application d’appareil du Microsoft Store ou une application haut débit mobile à l’aide de la plateforme DISM (Deployment Image Servicing and Management).

Note Cet article est destiné aux fabricants OEM qui prendront en charge une application d’appareil du Microsoft Store ou l’application haut débit mobile sur leurs appareils.

Pour chaque type d’application, deux éléments doivent être préinstallés pour fournir l’application d’appareil du Microsoft Store ou l’application haut débit mobile correcte :

Application d’appareil du Microsoft Store, préinstallation :
1. Package de métadonnées d’appareil
2. L’application
Application haut débit mobile du Microsoft Store, préinstaller :
1. Package de métadonnées de service
2. L’application

Important Bien que les packages de métadonnées et les applications correspondantes soient analysés immédiatement après la fin du processus OOBE, un utilisateur peut être en mesure de lancer l’application avant l’analyse du package de métadonnées. Dans ce cas, l’utilisateur voit une erreur d’accès refusé. Pour éviter cela, appliquez le package de métadonnées et l’application à l’image système.

Préinstaller les métadonnées d’appareil ou le package de métadonnées de service

Pour préinstaller un package de métadonnées de service ou de métadonnées d’appareil

Si vous préinstallez une application d’appareil du Microsoft Store, vous devez avoir acquis le package de métadonnées d’appareil. Si vous préinstallez une application haut débit mobile, vous devez avoir acquis le package de métadonnées de service.

Note Les packages de métadonnées d’appareil et les packages de métadonnées de service utilisent la même extension de nom de fichier (.devicemetadata-ms).
Copiez les métadonnées d’appareil ou le package de métadonnées de service (fichier devicemetadata-ms) dans votre image système dans le dossier %ProgramData%\Microsoft\Windows\DeviceMetadataStore . Vous pouvez le faire de l’une des manières suivantes :
- En ligne avant d’exécuter Sysprep
- Hors connexion après l’exécution de Sysprep à l’aide de DISM. Pour ce faire :
  1. Montez l’image hors connexion à des fins de maintenance.
```
Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline
```
  2. Copiez les fichiers de package de métadonnées dans le magasin de métadonnées de l’appareil de l’image montée. Par exemple, pour copier le fichier de package de métadonnées 0ECF2029-2C6A-41AE-9E0A-63FFC9EAD877.devicemetadata-ms dans le magasin de métadonnées d’appareil, ProgramData\Microsoft\Windows\DeviceMetadataStore :
```
copy 0ECF2029-2C6A-41AE-9E0A-63FFC9EAD877.devicemetadata-ms C:\test\offline\ProgramData\Microsoft\Windows\DeviceMetadataStore
```
  3. Enregistrez les modifications et démontez l’image.
```
dism /Unmount-Image /mountdir: c:\test\offline /commit
```
  Pour plus d’informations sur la maintenance des images hors connexion, consultez Vue d’ensemble de DISM.

Pour plus d’informations sur les métadonnées de service, consultez Métadonnées de service.

Préinstaller l’application d’appareil du Microsoft Store ou l’application haut débit mobile

Pour préinstaller l’application d’appareil du Microsoft Store ou l’application haut débit mobile

Montez l’image hors connexion à des fins de maintenance.

Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline

Ajoutez l’application d’appareil du Microsoft Store ou l’application haut débit mobile à l’image.
```
dism /Image:<mounted folder> /Add-ProvisionedAppxPackage /FolderPath:<appxpackage path>
```

Enregistrez les modifications et démontez l’image.

dism /Unmount-Image /mountdir: c:\test\offline /commit

Partager via