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>

重設

ResetXML 元素可以包含 專案： <Run> 和 <SystemDisk> 。

執行

<Run>XML 元素可用來將自訂腳本新增至按鈕重設功能。

您可以在單一ResetConfig.xml檔案中指定最多四 Run 個專案。 每個 Run 元素都必須包含其 Phase 屬性的不同 [ExtPoint] 值。

下表描述可新增至 Run 元素的有效元素：

元素 描述

Run Phase="[ExtPoint]""

每個 Run 元素都會定義要使用的擴充點、在該擴充點執行的腳本，以及以分鐘為單位的預估時間持續時間。

Phase 屬性 (Attribute) 是必要項。 它只接受 [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 會自訂裸機復原功能。 如需詳細資訊，請參閱 建立媒體以執行Push-Button重設功能。

您可以指定一個 <SystemDisk> 區段。 以下是必要和選擇性元素：

元素 描述
MinSize

必要。 指定主要硬碟所需的最小大小，以 MB 為單位。

如果系統磁片不符合此大小需求，裸機復原將無法繼續。

DiskpartScriptPath

必要。 相對於 C：\Recovery\OEM 的 Diskpart 腳本路徑。 腳本應該假設所有現有的分割區都已刪除，而且系統磁片在 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>

按鈕重設概觀

建立媒體以執行Push-Button重設功能