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
元素的有效元素:
元素 | 描述 |
---|---|
|
每個
您可以在單一ResetConfig.xml檔案中指定最多四 |
|
指定特定 路徑必須是包含ResetConfig.xml (資料夾的腳本相對路徑,通常是 C:\Recovery\OEM) 。 |
|
指定您預期自訂腳本執行的估計時間,以分鐘為單位。 此估計值用來在 GUI 中顯示進度資訊。 持續時間必須是整數,且必須介於 1 到 5 之間。 |
|
指定要在執行自訂腳本或可執行檔時使用的命令列參數。 此值會被視為字串,而且可以包含多個參數。
|
SystemDisk
元素 SystemDisk
會自訂裸機復原功能。 如需詳細資訊,請參閱 建立媒體以執行Push-Button重設功能。
您可以指定一個 <SystemDisk>
區段。 以下是必要和選擇性元素:
元素 | 描述 |
---|---|
MinSize
|
必要。 指定主要硬碟所需的最小大小,以 MB 為單位。 如果系統磁片不符合此大小需求,裸機復原將無法繼續。 |
|
必要。 相對於 C:\Recovery\OEM 的 Diskpart 腳本路徑。 腳本應該假設所有現有的分割區都已刪除,而且系統磁片在 Diskpart 中具有焦點。 例如,如果復原腳本位於 |
|
必要。 應該還原 OS 的分割區。 ESP 或作用中磁碟分割必須與 OS 位於相同的磁片上。 |
|
必要。 指定安裝Windows RE開機映射的分割區。 |
|
必要。 指定 Winre.wim 開機映射複製並暫存的資料夾路徑,相對於元素中指定的 |
|
選擇性。 install.wim 中要在裸機復原期間套用的映射索引。 此元素是選擇性的,只有在製造商建立的復原媒體上才需要 |
|
選擇性。 指定是否應該使用啟用個別檔案壓縮來套用復原映射。 此元素是選擇性的,而且只有在製造商建立的復原媒體上才需要。
|
|
此設定在 Windows 10 中已被取代。 |
|
此設定在 Windows 10 中已被取代。 |
|
此設定在 Windows 10 中已被取代。 |
|
此設定在 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>