Ajouter un outil personnalisé au menu de démarrage avancé Windows RE

Article
06/19/2023

Vous pouvez ajouter un outil de dépannage ou de diagnostic personnalisé à l’image De l’environnement de récupération Windows (WinRE). Cet outil s’affiche dans le menu Démarrage avancé.

En développant votre outil personnalisé pour s’exécuter dans WinRE, vous pouvez tirer parti de la prise en charge du clavier tactile et à l’écran disponible dans WinRE.

Nouveauté pour Windows 10 : vous ne pourrez pas ajouter de composants facultatifs WinRE qui ne figurent pas déjà dans les outils WinRE par défaut. Par exemple, si vous avez une application de Windows 8 qui dépendait des composants facultatifs .NET, vous devez réécrire l’application pour Windows 10.

Ajouter un outil personnalisé

Extrayez et montez une image Windows (install.wim) et son image WinRE correspondante (winre.wim) :

md c:\mount
xcopy D:\sources\install.wim C:\mount 
md C:\mount\windows
Dism /mount-image /imagefile:C:\mount\install.wim /index:1 /mountdir:C:\mount\windows 
md C:\mount\winre 
Dism /mount-image /imagefile:c:\mount\windows\windows\system32\recovery\winre.wim /index:1 /mountdir:C:\mount\winre

Pour plus d’informations sur ces étapes, consultez la rubrique : Personnaliser Windows RE.

Dans le Bloc-notes, créez un fichier de configuration qui spécifie le nom de fichier et les paramètres de l’outil personnalisé (le cas échéant) :
```
<?xml version="1.0" encoding="utf-8"?>

<Recovery>
   <RecoveryTools>
      <RelativeFilePath>OEMDiagnostics.exe</RelativeFilePath>
      <CommandLineParam>/param1 /param2</CommandLineParam>
   </RecoveryTools>
</Recovery>
```
Où C:\Tools\OEMDiagnostics.exe est l’outil de résolution des problèmes ou de diagnostics personnalisé, et où /param1 et /param2 sont des paramètres facultatifs utilisés lors de l’exécution de cet outil personnalisé.

Notes

Vous ne pouvez ajouter qu’un seul outil personnalisé aux menus de démarrage avancés WinRE.

Enregistrez le fichier à l’aide du codage UTF-8. N’utilisez pas ANSI :

Cliquez sur Fichier, puis sur Enregistrer sous. Dans la zone Encodage , sélectionnez UTF-8, puis enregistrez ce fichier en tant que C:\mount\WinREConfig.xml.
Créez un \Sources\Recovery\Tools dossier dans le dossier de montage WinRE, puis copiez l’outil personnalisé et son fichier de configuration dans le nouveau dossier :
```
md C:\mount\winre\sources\recovery\tools
copy C:\Tools\OEMDiagnostics.exe C:\mount\winre\sources\recovery\tools
copy C:\mount\WinREConfig.xml C:\mount\winre\sources\recovery\tools
```
L’outil personnalisé et tous les dossiers associés doivent se trouver dans ce dossier afin qu’il puisse continuer à fonctionner après les futures mises à niveau de WinRE.
Validez vos personnalisations et démontez l’image WinRE :
```
Dism /unmount-image /mountdir:C:\mount\winre /commit
```
Facultatif : effectuer une copie de sauvegarde de l’image WinRE.
```
copy C:\mount\windows\windows\system32\recovery\winre.wim C:\mount\winre_amd64_backup.wim
```
Vous pouvez souvent réutiliser les mêmes personnalisations sur plusieurs images.
Démontez et enregistrez les modifications de l’image Windows de base :
```
Dism /unmount-image /mountdir:C:\mount\windows /commit
```

Déployer l'image

Dans le Bloc-notes, créez un fichier de configuration qui décrit l’outil personnalisé dans le menu Démarrage avancé. Ajoutez des descriptions pour chaque langue prise en charge. Cet exemple spécifie à la fois les versions en anglais et Français langue du nom et de la description de l’outil :
```
<?xml version="1.0" encoding="utf-8"?>

<BootShell>
   <WinRETool locale="en-us">
         <Name>Fabrikam Utility</Name>
         <Description>Troubleshoot your Fabrikam PC</Description>
   </WinRETool>
   <WinRETool locale="fr-fr">
      <Name>Utilité de Fabrikam</Name>
      <Description>Dépannez votre PC de Fabrikam</Description>
   </WinRETool>
</BootShell>
```
Avertissement

Limitez les <Name> valeurs et <Description> à environ 30 caractères ou moins pour vous assurer qu’elles s’affichent correctement dans le menu Démarrage avancé.

Enregistrez le fichier à l’aide du codage UTF-8 :

Cliquez sur Fichier, puis sur Enregistrer sous. Dans la zone Encodage , sélectionnez UTF-8, puis enregistrez ce fichier en tant que E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml.

Où E:\ est la lettre de lecteur d’un lecteur amovible ou d’un emplacement réseau.
Sur votre ordinateur de destination, pendant le déploiement de l’image, mais après avoir inscrit l’image de démarrage WinRE personnalisée et le système d’exploitation Windows, vous devez inscrire la description de l’outil personnalisé :
```
Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
```
Si l’outil personnalisé est correctement inscrit, la sortie de l’exécution de cette commande sera : <OEM Tool = 1>.

Notes

Pour plus d’informations sur le déploiement de Windows, consultez la rubrique Déployer Windows RE.

Redémarrez l’ordinateur de destination et terminez OOBE en tant qu’utilisateur.

Notes

Si vous êtes invité à entrer une clé de produit, cliquez sur Ignorer.
Cliquez sur Paramètres duPC de démarrage>, puis sélectionnez Général.
Dans la section Démarrage avancé , sélectionnez Redémarrer maintenant.

Le menu de démarrage avancé de Windows s’affiche.
Dans le menu Démarrage avancé , sélectionnez Résoudre les problèmes, puis cliquez sur le lien Utilitaire Fabrikam .

L’ordinateur redémarre dans WinRE et l’outil spécifié dans la <section RecoveryTools> du fichier WinREConfig.xml s’affiche.
Vérifiez que l’outil personnalisé fonctionne correctement, puis fermez l’outil.

Si l’outil personnalisé n’apparaît pas dans le menu Démarrage avancé, vous pouvez essayer les opérations suivantes :
- Vérifiez que les fichiers WinREConfig.xml et AddDiagnosticsToolToBootMenu.xml sont enregistrés au format d’encodage UTF-8.
- Désactivez WinRE, réinscrivez l’outil personnalisé, puis activez WinRE. Par exemple :
```
Reagentc /disable 
Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
Reagentc /enable
```

Dans le menu de récupération, sélectionnez Résoudre les problèmes, puis cliquez sur le lien Utilitaire Fabrikam .
Vérifiez que l’outil personnalisé fonctionne correctement, puis fermez l’outil.
Cliquez sur Continuer.

Le PC redémarre dans le système d’exploitation.

Informations de référence techniques sur l’environnement de récupération Windows (Windows RE)

Personnaliser Windows RE

Déployer Windows RE

Fonctionnalités de résolution des problèmes de Windows RE