Справочник по XML-файлу ResetConfig

  • Статья

В этом справочнике описаны все XML-элементы, используемые для создания файла ResetConfig.xml, используемого для настройки функций сброса кнопок в среде восстановления Windows.

ResetConfig XML

Ниже приведен пустой ResetConfig.xml, который можно использовать в качестве отправной точки:

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

Xml-элемент Reset может содержать элементы : <Run> и <SystemDisk>.

Выполнить

XML-элемент <Run> используется для добавления пользовательских скриптов в функции сброса кнопок.

В одном файле ResetConfig.xml можно указать до четырех Run элементов. Каждый Run элемент должен содержать разные [ExtPoint] значения для своего Phase атрибута.

В следующей таблице описаны допустимые элементы, которые можно добавить в Run элемент :

Элемент Описание

Run Phase="[ExtPoint]""

Каждый Run элемент определяет используемую точку расширяемости, скрипт, который выполняется в этой точке расширения, и предполагаемую длительность времени в минутах.

Атрибут Phase является обязательным. Он принимает только следующие значения для [ExtPoint]:

  • BasicReset_BeforeImageApply. Запускает указанную программу в точке расширяемости A.

  • BasicReset_AfterImageApply. Запускает указанную программу в точке расширяемости B

  • FactoryReset_AfterDiskFormat. Запускает указанную программу в точке расширяемости C

  • FactoryReset_AfterImageApply. Запускает указанную программу в точке расширяемости D

В одном файле ResetConfig.xml можно указать до четырех Run разделов. Однако каждый Run раздел должен содержать разные значения для атрибута phase.

Path

Указывает расположение скрипта для определенного Run раздела.

Путь должен быть относительным путем к скрипту из папки, содержащей ResetConfig.xml (обычно это C:\Recovery\OEM).

Duration

Указывает предполагаемое время выполнения пользовательского скрипта в минутах. Эта оценка используется для отображения сведений о ходе выполнения в графическом пользовательском интерфейсе.

Длительность должна быть целым числом и находиться в диапазоне от 1 до 5.

Param

Указывает параметры командной строки, используемые при запуске пользовательского скрипта или исполняемого файла. Значение обрабатывается как строка и может содержать несколько параметров.

Param не поддерживает пустые элементы. Если для скрипта не требуются параметры, не включайте этот элемент. Примеры см. в разделе Использование ResetConfig.xml далее в этом разделе.

SystemDisk

Элемент SystemDisk настраивает функциональные возможности восстановления без операционной системы. Дополнительные сведения см. в статье Создание носителя для запуска функций сброса Push-Button.

Можно указать один <SystemDisk> раздел. Ниже приведены обязательные и необязательные элементы.

Элемент Описание
MinSize

Обязательный. Указывает минимальный необходимый размер для основного жесткого диска в мегабайтах.

Восстановление без операционной системы не будет продолжено, если системный диск не соответствует этому требованию к размеру.

DiskpartScriptPath

Обязательный. Путь к скрипту Diskpart относительно C:\Recovery\OEM. Сценарий должен предполагать, что все существующие разделы удалены, а системный диск имеет фокус в Diskpart.

Например, если скрипты восстановления находятся в C:\Recovery\OEM\Scripts\RecreatePartitions.dps, используйте значение \Scripts\RecreatePartitions.dps.

OSPartition

Обязательный. Раздел, в который должна быть восстановлена ОС. Esp или активный раздел должен находиться на том же диске, что и ОС.

WindowsREPartition

Обязательный. Указывает раздел, в котором установлен загрузочный образ Windows RE.

WindowsREPath

Обязательный. Указывает путь к папке, в которой копируется и выполняется промежуточное копирование загрузочного образа Winre.wim, относительно корня секции, указанной в элементе WindowsREPartition .

RestoreFromIndex

Необязательный элемент. Индекс образа в файле install.wim, применяемый во время восстановления без операционной системы. Этот элемент является необязательным и требуется только на носителе восстановления, созданном производителем.

Compact

Необязательный элемент. Указывает, следует ли применять образ восстановления с включенным сжатием для каждого файла. Этот элемент является необязательным и требуется только на созданном производителем носителе для восстановления.

Compact принимает следующие значения:

  • True: файлы, примененные из образа, сжимаются по отдельности.
  • False (значение по умолчанию): сжатие не используется.

RecoveryImagePartition

Этот параметр не рекомендуется использовать в Windows 10.

RecoveryImagePath

Этот параметр не рекомендуется использовать в Windows 10.

RecoveryImageIndex

Этот параметр не рекомендуется использовать в Windows 10.

WIMBoot

Этот параметр не рекомендуется использовать в Windows 10.

Использование ResetConfig.xml

Если для создания файлов .xml используется текстовый редактор, необходимо сохранить документ с расширением имени файла .xml и использовать кодировку UTF-8. Не используйте ANSI или любую другую кодировку.

Эти файлы должны быть помещены в папку C:\Recovery\OEM , чтобы их можно было автоматически обнаружить с помощью функций сброса кнопок.

Пример

Это пример кода для файла 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>

Общие сведения о сбросе кнопок

Создание носителя для запуска функций сброса Push-Button