Partager via

Référence XML ResetConfig

  • Article

Cette référence décrit tous les éléments XML utilisés pour créer le fichier ResetConfig.xml, utilisé pour configurer les fonctionnalités de réinitialisation par bouton push de l’environnement de récupération Windows.

ResetConfig XML

Voici un ResetConfig.xml vide que vous pouvez utiliser comme point de départ :

<?xml version="1.0" encoding="utf-8"?>
<Reset>
 <Run Phase="BasicReset_BeforeImageApply">
   <Path></Path>
   <Duration></Duration>
 </Run>
 <Run Phase="BasicReset_AfterImageApply">
   <Path></Path>
   <Param></Param>
   <Duration></Duration>
 </Run>
 <Run Phase="FactoryReset_AfterDiskFormat">
   <Path></Path>
   <Duration></Duration>
 </Run>
 <Run Phase="FactoryReset_AfterImageApply">
   <Path></Path>
   <Param></Param>
   <Duration></Duration>
 </Run>
 <SystemDisk>
   <MinSize></MinSize>
   <DiskpartScriptPath> </DiskpartScriptPath>
   <OSPartition></OSPartition>
   <RestoreFromIndex></RestoreFromIndex>
   <WindowsREPartition></WindowsREPartition>
   <WindowsREPath></WindowsREPath>
   <Compact></Compact>
 </SystemDisk>
</Reset>

Réinitialiser

L’élément Reset XML peut contenir les éléments : <Run> et <SystemDisk>.

Exécuter

L’élément <Run> XML est utilisé pour ajouter des scripts personnalisés aux fonctionnalités de réinitialisation par bouton.

Vous pouvez spécifier jusqu’à quatre Run éléments dans un seul fichier ResetConfig.xml. Chaque Run élément doit contenir une valeur différente [ExtPoint] pour son Phase attribut.

Le tableau suivant décrit les éléments valides qui peuvent être ajoutés à l’élément Run :

Élément Description

Run Phase="[ExtPoint]""

Chaque Run élément définit le point d’extensibilité à utiliser, le script exécuté à ce point d’extensibilité et la durée estimée en minutes.

L'attribut Phase est obligatoire. Il accepte uniquement les valeurs suivantes pour [ExtPoint] :

  • BasicReset_BeforeImageApply. Exécute le programme spécifié au point d’extensibilité A.

  • BasicReset_AfterImageApply. Exécute le programme spécifié au point d’extensibilité B

  • FactoryReset_AfterDiskFormat. Exécute le programme spécifié au point d’extensibilité C

  • FactoryReset_AfterImageApply. Exécute le programme spécifié au point d’extensibilité D

Vous pouvez spécifier jusqu’à quatre Run sections dans un seul fichier ResetConfig.xml. Toutefois, chaque Run section doit contenir une valeur différente pour l’attribut phase.

Path

Spécifie l’emplacement du script pour une section particulière Run .

Le chemin d’accès doit être le chemin relatif du script du dossier qui contient ResetConfig.xml (généralement C:\Recovery\OEM).

Duration

Spécifie la durée estimée, en minutes, pendant laquelle vous attendez que le script personnalisé s’exécute. Cette estimation est utilisée pour afficher les informations de progression dans l’interface graphique graphique.

La durée doit être un entier et doit être comprise entre 1 et 5.

Param

Spécifie les paramètres de ligne de commande à utiliser lorsque vous exécutez le script personnalisé ou le fichier exécutable. La valeur est traitée comme une chaîne et peut contenir plusieurs paramètres.

Param ne prend pas en charge les éléments vides. Si votre script ne nécessite pas de paramètres, n’incluez pas cet élément. Pour obtenir des exemples, consultez Utilisation de ResetConfig.xml plus loin dans cette rubrique.

SystemDisk

L’élément SystemDisk personnalise la fonctionnalité de récupération nue. Pour plus d’informations, consultez Créer un média pour exécuter Push-Button réinitialiser les fonctionnalités.

Vous pouvez spécifier une <SystemDisk> section. Voici les éléments obligatoires et facultatifs :

Élément Description
MinSize

Obligatoire. Spécifie la taille minimale requise pour le disque dur principal, en mégaoctets.

La récupération nue ne se poursuit pas si le disque système ne répond pas à cette exigence de taille.

DiskpartScriptPath

Obligatoire. Chemin d’accès au script Diskpart relatif à C:\Recovery\OEM. Le script doit supposer que toutes les partitions existantes ont été supprimées et que le disque système a le focus dans Diskpart.

Par exemple, si les scripts de récupération se trouvent dans C:\Recovery\OEM\Scripts\RecreatePartitions.dps, utilisez la valeur \Scripts\RecreatePartitions.dps.

OSPartition

Obligatoire. Partition sur laquelle le système d’exploitation doit être restauré. L’ESP ou la partition active doit se trouver sur le même disque que le système d’exploitation.

WindowsREPartition

Obligatoire. Spécifie la partition où l’image de démarrage Windows RE est installée.

WindowsREPath

Obligatoire. Spécifie le chemin du dossier où l’image de démarrage Winre.wim est copiée et intermédiaire, par rapport à la racine de la partition spécifiée dans l’élément WindowsREPartition .

RestoreFromIndex

facultatif. Index de l’image dans install.wim à appliquer pendant la récupération nue. Cet élément est facultatif et n’est nécessaire que sur le support de récupération créé par le fabricant

Compact

facultatif. Spécifie si l’image de récupération doit être appliquée avec la compression par fichier activée. Cet élément est facultatif et n’est nécessaire que sur le support de récupération créé par le fabricant.

Compact accepte les valeurs suivantes :

  • True: les fichiers appliqués à partir de l’image sont compressés individuellement.
  • False (valeur par défaut) : la compression n’est pas utilisée.

RecoveryImagePartition

Ce paramètre est déconseillé dans Windows 10.

RecoveryImagePath

Ce paramètre est déconseillé dans Windows 10.

RecoveryImageIndex

Ce paramètre est déconseillé dans Windows 10.

WIMBoot

Ce paramètre est déconseillé dans Windows 10.

Utilisation de ResetConfig.xml

Si vous utilisez un éditeur de texte pour créer vos fichiers .xml, vous devez enregistrer le document avec une extension de nom de fichier .xml et utiliser l’encodage UTF-8. N’utilisez pas ANSI ou tout autre encodage.

Ces fichiers doivent être placés dans le dossier C:\Recovery\OEM afin qu’ils puissent être détectés automatiquement par les fonctionnalités de réinitialisation par bouton push.

Exemple

Il s’agit d’un exemple de code pour le fichier ResetConfig.xml.

<?xml version="1.0" encoding="utf-8"?>
<Reset>
 <Run Phase="BasicReset_BeforeImageApply">
   <Path>Fabrikam\CopyFiles.cmd</Path>
   <Duration>2</Duration>
 </Run>
 <Run Phase="BasicReset_AfterImageApply">
   <Path>Fabrikam\InstallDrivers.cmd</Path>
   <Param>/allDrivers</Param>
   <Duration>2</Duration>
 </Run>
 <Run Phase="FactoryReset_AfterDiskFormat">
   <Path>Fabrikam\FixPartitions.exe</Path>
   <Duration>2</Duration>
 </Run>
 <Run Phase="FactoryReset_AfterImageApply">
   <Path>Fabrikam\InstallDrivers.cmd</Path>
   <Param>/allDrivers</Param>
   <Duration>2</Duration>
 </Run>
 <SystemDisk>
   <MinSize>75000</MinSize>
   <DiskpartScriptPath>Fabrikam\CreatePartition.txt </DiskpartScriptPath>
   <OSPartition>4</OSPartition>
   <RestoreFromIndex>2</RestoreFromIndex>
   <WindowsREPartition>1</WindowsREPartition>
   <WindowsREPath>Recovery\WindowsRE</WindowsREPath>
   <Compact>False</Compact>
 </SystemDisk>
</Reset>

Vue d’ensemble de la réinitialisation par bouton

Créer un média pour exécuter Push-Button réinitialiser les fonctionnalités