ResetConfig-XML-Referenz

  • Artikel

In dieser Referenz werden alle XML-Elemente beschrieben, die zum Erstellen der Datei ResetConfig.xml verwendet werden, die zum Konfigurieren der Funktionen zum Zurücksetzen auf Knopfdruck der Windows-Wiederherstellungsumgebung verwendet wird.

ResetConfig-XML

Hier ist eine leere ResetConfig.xml, die Sie als Ausgangspunkt verwenden können:

<?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>

Reset

Das Reset XML-Element kann die Elemente enthalten: <Run> und <SystemDisk>.

Ausführen

Das <Run> XML-Element wird verwendet, um benutzerdefinierte Skripts zu Funktionen zum Zurücksetzen auf Knopfdruck hinzuzufügen.

Sie können bis zu vier Run-Elemente in einer einzelnen ResetConfig.xml-Datei angeben. Jedes Run-Element muss einen anderen [ExtPoint]-Wert für sein Phase-Attribut enthalten.

Die folgende Tabelle beschreibt die gültigen Elemente, die dem Run-Element hinzugefügt werden können:

Element Beschreibung

Run Phase="[ExtPoint]""

Jedes Run-Element definiert den zu verwendenden Erweiterbarkeitspunkt, das Skript, das an diesem Erweiterbarkeitspunkt ausgeführt wird, und die geschätzte Zeitdauer in Minuten.

Das Phase-Attribut ist erforderlich. Es akzeptiert nur die folgenden Werte für [ExtPoint]:

  • BasicReset_BeforeImageApply. Führt das angegebene Programm am Erweiterungspunkt A aus.

  • BasicReset_AfterImageApply. Führt das angegebene Programm am Erweiterungspunkt B aus

  • FactoryReset_AfterDiskFormat. Führt das angegebene Programm am Erweiterungspunkt C aus

  • FactoryReset_AfterImageApply. Führt das angegebene Programm am Erweiterungspunkt D aus

Sie können bis zu vier Run-Abschnitte in einer einzelnen ResetConfig.xml-Datei angeben. Allerdings muss jeder Run-Abschnitt einen anderen Wert für das Phasenattribut enthalten.

Path

Gibt den Speicherort des Skripts für einen bestimmten Run-Abschnitt an.

Der Pfad muss der relative Pfad des Skripts aus dem Ordner sein, der ResetConfig.xml enthält (normalerweise ist dies C:\Recovery\OEM).

Duration

Gibt die geschätzte Zeit in Minuten an, die Sie für die Ausführung des benutzerdefinierten Skripts erwarten. Diese Schätzung wird verwendet, um Fortschrittsinformationen in der GUI anzuzeigen.

Die Dauer muss eine ganze Zahl sein und zwischen 1 und 5 liegen.

Param

Gibt die zu verwendenden Befehlszeilenparameter an, wenn Sie das benutzerdefinierte Skript oder die ausführbare Datei ausführen. Der Wert wird als String behandelt und kann mehrere Parameter enthalten.

Param unterstützt keine leeren Elemente. Wenn Ihr Skript keine Parameter erfordert, schließen Sie dieses Element nicht ein. Beispiele finden Sie weiter unten in diesem Thema unter Verwenden von ResetConfig.xml.

SystemDisk

Das SystemDisk-Element passt die Bare-Metal-Recovery-Funktionalität an. Weitere Informationen finden Sie unter Erstellen von Medien zum Ausführen von Funktionen zum Zurücksetzen auf Knopfdruck.

Sie können einen <SystemDisk>-Abschnitt angeben. Hier sind die erforderlichen und optionalen Elemente:

Element Beschreibung
MinSize

Erforderlich. Gibt die erforderliche Mindestgröße für die primäre Festplatte in Megabyte an.

Die Bare-Metal-Wiederherstellung wird nicht fortgesetzt, wenn die Systemfestplatte diese Größenanforderung nicht erfüllt.

DiskpartScriptPath

Erforderlich. Pfad zum Diskpart-Skript relativ zu C:\Recovery\OEM. Das Skript sollte davon ausgehen, dass alle vorhandenen Partitionen gelöscht wurden und der Systemdatenträger den Fokus in Diskpart hat.

Wenn sich die Wiederherstellungsskripts beispielsweise unter C:\Recovery\OEM\Scripts\RecreatePartitions.dps befinden, verwenden Sie den Wert \Scripts\RecreatePartitions.dps.

OSPartition

Erforderlich. Die Partition, auf der das Betriebssystem wiederhergestellt werden soll. Die ESP-Partition oder aktive Partition muss sich auf demselben Datenträger wie das Betriebssystem befinden.

WindowsREPartition

Erforderlich. Gibt die Partition an, auf der das Windows RE-Startimage installiert ist.

WindowsREPath

Erforderlich. Gibt den Ordnerpfad an, in den das Winre.wim-Startimage kopiert und bereitgestellt wird, relativ zum Stamm der im WindowsREPartition-Element angegebenen Partition.

RestoreFromIndex

Optional. Der Index des Images in install.wim, das während der Bare-Metal-Wiederherstellung angewendet werden soll. Dieses Element ist optional und wird nur auf vom Hersteller erstellten Wiederherstellungsmedien benötigt

Compact

Optional. Gibt an, ob das Wiederherstellungsabbild mit aktivierter Komprimierung pro Datei angewendet werden soll. Dieses Element ist optional und wird nur auf vom Hersteller erstellten Wiederherstellungsmedien benötigt.

Compact akzeptiert die folgenden Werte:

  • True: Aus dem Image übernommene Dateien werden einzeln komprimiert.
  • False (Standardwert): Komprimierung wird nicht verwendet.

RecoveryImagePartition

Diese Einstellung ist in Windows 10 veraltet.

RecoveryImagePath

Diese Einstellung ist in Windows 10 veraltet.

RecoveryImageIndex

Diese Einstellung ist in Windows 10 veraltet.

WIMBoot

Diese Einstellung ist in Windows 10 veraltet.

Verwenden von ResetConfig.xml

Wenn Sie Ihre .xml-Dateien mit einem Texteditor erstellen, müssen Sie das Dokument mit der Dateinamenerweiterung .xml speichern und die UTF-8-Codierung verwenden. Verwenden Sie keine ANSI- oder andere Codierung.

Diese Dateien sollten im Ordner C:\Recovery\OEM abgelegt werden, damit sie automatisch von den Push-Button-Reset-Funktionen erkannt werden können.

Beispiel

Dies ist ein Codebeispiel für die Datei 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>

Übersicht über das Zurücksetzen per Drucktaste

Erstellen Sie Medien zum Ausführen von Push-Button-Reset-Funktionen