ResetConfig XML リファレンス

このリファレンスでは、ResetConfig.xml ファイルの作成時に使用するすべての XML 要素について説明します。これは、Windows 回復環境の PC のリカバリ機能の設定に使用されます。

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 要素は、カスタム スクリプトを PC のリカバリ機能に追加する際に使用します。

1 つの ResetConfig.xml ファイルでは、最大 4 つの Run 要素を指定できます。 各 Run 要素では、[ExtPoint] 属性に異なる Phase 値が含まれている必要があります。

次の表では、Run 要素に追加できる有効な要素について説明しています。

要素	説明
Run Phase="[ExtPoint]""	各 Run 要素では、使用する機能拡張ポイント、その機能拡張ポイントで実行するスクリプト、推定所用時間を分単位で定義します。 Phase 属性は必須です。 [ExtPoint] として次の値のみが受け入れられます。 BasicReset_BeforeImageApply. 機能拡張ポイント A で、指定されたプログラムが実行されます。 BasicReset_AfterImageApply. 機能拡張ポイント B で、指定されたプログラムが実行されます FactoryReset_AfterDiskFormat. 機能拡張ポイント C で、指定されたプログラムが実行されます FactoryReset_AfterImageApply. 機能拡張ポイント D で、指定されたプログラムが実行されます 1 つの ResetConfig.xml ファイルでは、最大 4 つの Run セクションを指定できます。 ただし、各 Run セクションでは、Phase 属性に異なる値が含まれている必要があります。
Path	特定の Run セクションのスクリプトの場所を指定します。 パスは、ResetConfig.xml が格納されているフォルダーからの、スクリプトの相対パスである必要があります (通常は、C:\Recovery\OEM)。
Duration	カスタム スクリプトの実行にかかることが予想される推定時間を分単位で指定します。 この推定値は、GUI に進行状況を表示する際に使用されます。 時間は 1 - 5 の整数で指定する必要があります。
Param	カスタム スクリプトまたは実行可能ファイルの実行時に使用するコマンドライン パラメーターを指定します。 値は文字列として扱われ、複数のパラメーターを含めることができます。 Param では、空の要素はサポートされていません。 スクリプトにパラメーターが必要でない場合は、この要素を含めないでください。 例については、このトピックの「ResetConfig.xml を使用する」を参照してください。

SystemDisk

SystemDisk 要素では、ベア メタル回復機能をカスタマイズします。 詳細については、PC のリカバリ機能を実行するためのメディアの作成に関するページを参照してください。

1 つの <SystemDisk> セクションを指定できます。 必須と省略可能な要素は次のとおりです。

要素	説明
MinSize	必須。 プライマリ ハード ドライブに必要な最小サイズをメガバイト単位で指定します。 システム ディスクがこのサイズ要件を満たしていない場合、ベア メタル回復は続行されません。
DiskpartScriptPath	必須。 C:\Recovery\OEM を基準とした Diskpart スクリプトへのパス。 このスクリプトでは、すべての既存パーティションが削除されていること、およびシステム ディスクで Diskpart にフォーカスが設定されていることを前提とする必要があります。 たとえば、回復スクリプトが C:\Recovery\OEM\Scripts\RecreatePartitions.dps にある場合、値 \Scripts\RecreatePartitions.dps を使用します。
OSPartition	必須。 OS を復元するパーティション。 ESP またはアクティブ パーティションは、OS と同じディスクに設定する必要があります。
WindowsREPartition	必須。 Windows RE ブート イメージがインストールされているパーティションを指定します。
WindowsREPath	必須。 WindowsREPartition 要素で指定されたパーティションのルートを基準として、Winre.wim ブート イメージがコピーおよびステージングされるフォルダーのパスを指定し ます。
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 などのエンコードは使用しないでください。

これらのファイルは、PC のリカバリ機能によって自動的に検出されるように、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>

関連トピック

プッシュ ボタン リセットの概要

PC のリカバリー機能を実行するためのメディアの作成