ResetConfig XML 参考

  • 项目

此参考介绍用于创作 ResetConfig.xml 文件的所有 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 元素可以包含 <Run> 和 <SystemDisk> 元素。

运行

<Run> XML 元素用于将自定义脚本添加到一键重置功能。

一个 ResetConfig.xml 文件中最多可以指定四个 Run 元素。 每个 Run 元素必须包含不同的对应于 Phase 属性的 [ExtPoint] 值。

下表描述了可以添加到 Run 元素中的有效元素：

元素 说明

Run Phase="[ExtPoint]""

每个 Run 元素定义要使用的扩展点、在该扩展点执行的脚本，以及估计的持续时间（以分钟计）。

需要 Phase 属性。 它仅接受 [ExtPoint] 的以下值：

  • BasicReset_BeforeImageApply。 在扩展点 A 处运行指定的程序。

  • BasicReset_AfterImageApply。 在扩展点 B 处运行指定的程序。

  • FactoryReset_AfterDiskFormat。 在扩展点 C 处运行指定的程序。

  • FactoryReset_AfterImageApply。 在扩展点 D 处运行指定的程序。

一个 ResetConfig.xml 文件中最多可以指定四个 Run 节。 但是，每个 Run 节必须包含不同的对应于阶段属性的值。

Path

指定特定 Run 节的脚本位置。

路径必须是包含 ResetConfig.xml 的文件夹中的脚本的相对路径（通常为 C:\Recovery\OEM）。

Duration

指定预计运行自定义脚本的时间（以分钟计）。 此估计值用于在 GUI 中显示进度信息。

持续时间必须为整数，必须介于 1 到 5 之间。

Param

指定在运行自定义脚本或可执行文件时使用的命令行参数。 此值被视为字符串，可以包含多个参数。

Param 不支持空元素。 如果脚本不需要参数，请不要包括此元素。 有关示例，请参阅本主题后面部分的使用 ResetConfig.xml。

SystemDisk

SystemDisk 元素自定义裸机恢复功能。 有关详细信息，请参阅创建介质以运行一键重置功能。

可以指定一个 <SystemDisk> 节。 下面是必需元素和可选元素：

元素 说明
MinSize

必需。 指定主硬盘驱动器所需的最小大小（以兆字节为单位）。

如果系统磁盘不满足此大小要求，裸机恢复将不会继续。

DiskpartScriptPath

必需。 Diskpart 脚本的路径（相对于 C:\Recovery\OEM）。 该脚本应假定已删除所有现有分区，且系统磁盘在 Diskpart 中有焦点。

例如，如果恢复脚本位于 C:\Recovery\OEM\Scripts\RecreatePartitions.dps，则使用值 \Scripts\RecreatePartitions.dps。

OSPartition

必需。 OS 应还原到的分区。 ESP 或活动分区必须与 OS 位于同一磁盘上。

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>

一键重置概述

创建介质以运行一键重置功能