ResetConfig XML リファレンスResetConfig XML reference

このリファレンスでは、Windows 回復環境のプッシュ ボタンのリセット機能を構成するために使用、ResetConfig.xml ファイルを作成するために使用するすべての XML 要素について説明します。This reference describes all XML elements that are used to author the ResetConfig.xml file, used to configure Windows Recovery Environment push-button reset features.

リセットReset

Reset XML 要素は、要素を含めることができます:RunSystemDiskします。The Reset XML element can contain the elements: Run and SystemDisk.

実行Run

Run XML 要素を使用して、プッシュするカスタム スクリプトのリセット機能を追加します。The Run XML element is used to add custom scripts to push-button reset features.

4 つを指定できますRunResetConfig.xml ファイルを 1 つの要素。You can specify up to four Run elements in a single ResetConfig.xml file. Run要素を別に含める必要があります*[ExtPoint]* 値、Phase属性。Each Run element must contain a different [ExtPoint] value for the Phase attribute.

次の表に、有効な要素を追加できる、Run要素。The following table describes the valid elements that can be added to the Run element:

要素Element 説明Description

Run Phase="[ExtPoint]""

Run要素は、使用する機能拡張ポイントを定義します。 スクリプトでは、機能拡張ポイントで実行され、時間の期間 (分) を推定します。Each Run element defines the extensibility point to be used, the script that is executed at that extensibility point, and estimated time duration in minutes.

Phase属性が必要です。The Phase attribute is required. 次の値のみを受け入れる[ExtPoint]:It accepts only the following values for [ExtPoint]:

  • BasicReset_BeforeImageApply の順にクリックします。BasicReset_BeforeImageApply. 機能拡張ポイント A. で指定したプログラムを実行します。Runs the specified program at extensibility point A.

  • BasicReset_AfterImageApply の順にクリックします。BasicReset_AfterImageApply. 機能拡張ポイント B で、指定したプログラムを実行します。Runs the specified program at extensibility point B

  • FactoryReset_AfterDiskFormat の順にクリックします。FactoryReset_AfterDiskFormat. 機能拡張ポイント C での指定したプログラムを実行します。Runs the specified program at extensibility point C

  • FactoryReset_AfterImageApply の順にクリックします。FactoryReset_AfterImageApply. 機能拡張ポイント D で、指定したプログラムを実行します。Runs the specified program at extensibility point D

4 つを指定できますRunResetConfig.xml ファイルを 1 つのセクション。You can specify up to four Run sections in a single ResetConfig.xml file. ただし、各Runセクションは、別のフェーズの属性の値を含める必要があります。However, each Run section must contain a different value for the phase attribute.

Path

特定のスクリプトの場所を指定しますRunセクション。Specifies the location of the script for a particular Run section.

パスは、スクリプトを ResetConfig.xml (通常、これは C:\Recovery\OEM) を含むフォルダーからの相対パスである必要があります。The path must be the relative path of the script from the folder which contains ResetConfig.xml (usually this is C:\Recovery\OEM).

Duration

カスタム スクリプトを実行すると予想される分単位で予測の時間を指定します。Specifies the estimated time, in minutes, that you expect the custom script to run. この見積もりは、GUI での進行状況に関する情報の表示に使用されます。This estimate is used to display progress information in the GUI.

期間は、整数を指定する必要があり、1 ~ 5 である必要があります。The duration must be an integer and must be between 1 and 5.

Param

カスタム スクリプトまたは実行可能ファイルを実行するときに使用するコマンド ライン パラメーターを指定します。Specifies the command-line parameters to use when you run the custom script or executable file. 値は、文字列として扱われ、複数のパラメーターを含めることができます。The value is treated as a string, and can contain multiple parameters.

Param 空の要素をサポートしません。does not support empty elements. スクリプトにパラメーターが必要としない場合、含めないこの要素。If your script does not require parameters, then do not include this element. 例については、を使用して ResetConfig.xmlこのトピックで後述を参照してください。For examples, see Using ResetConfig.xml later in this topic.

SystemDiskSystemDisk

SystemDisk要素は、ベア メタル回復機能をカスタマイズします。The SystemDisk element customizes bare metal recovery functionality. 詳細については、Push-Button リセット機能を実行するには、メディアの作成を参照してください。For more information, see Create Media to Run Push-Button Reset Features.

いずれかを指定できますSystemDiskセクション。You can specify one SystemDisk section. 必須および省略可能な要素を次に示します。Here's the required and optional elements:

要素Element 説明Description
MinSize

必須。Required. プライマリ ハード ドライブに最低限必要なサイズをメガバイト単位で指定します。Specifies the minimum required size for the primary hard drive, in megabytes.

ベア メタル回復の受注't 進む場合は、システム ディスクは't がこのサイズ要件を満たしています。Bare metal recovery won't proceed if the system disk doesn't meet this size requirement.

DiskpartScriptPath

必須。Required. C:\Recovery\OEM 基準とした Diskpart スクリプトへのパス。Path to Diskpart script relative to C:\Recovery\OEM. スクリプトは、既存のすべてのパーティションが削除されているし、Diskpart でシステムのディスクにフォーカスがあることを想定してください。The script should assume that all existing partitions have been deleted, and the system disk has focus in Diskpart.

たとえば、復旧のスクリプトはC:\Recovery\OEM\Scripts\RecreatePartitions.dps、値を使用して\Scripts\RecreatePartitions.dpsします。For example, if the recovery scripts are located at C:\Recovery\OEM\Scripts\RecreatePartitions.dps, use the value \Scripts\RecreatePartitions.dps.

OSPartition

必須。Required. オペレーティング システムを復元するパーティション。The partition to which the OS should be restored. ESP またはアクティブなパーティションは、OS と同じディスク上にある必要があります。The ESP or active partition must be on the same disk as the OS.

WindowsREPartition

必須。Required. Windows RE のブート イメージがインストールされているパーティションを指定します。Specifies the partition where the Windows RE boot image is installed.

WindowsREPath

必須。Required. Winre.wim ブート イメージのコピーし、で指定されたパーティションのルートを基準とした、ステージングの場所のフォルダー パスを指定します、WindowsREPartition要素。Specifies the folder path where the Winre.wim boot image is copied and staged, relative to the root of the partition specified in the WindowsREPartition element.

RestoreFromIndex

(省略可能)。Optional. ベア メタル回復中に適用される install.wim 内のイメージのインデックス。The index of the image within install.wim to be applied during bare metal recovery. この要素はオプションであり、製造元が作成したリカバリ メディアにのみ必要です。This element is optional and is only needed on manufacturer-created recovery media

Compact

(省略可能)。Optional. ファイルあたりの圧縮が有効な回復イメージを適用するかどうかを指定します。Specifies whether the recovery image should be applied with per-file compression enabled. この要素は省略可能で、製造元が作成したリカバリ メディアにのみ必要です。This element is optional and is only needed on manufacturer-created recovery media.

Compact 次の値を受け取ります。Compact accepts the following values:

  • True:イメージから適用されるファイルは、個別に圧縮されます。True: Files applied from the image are compressed individually.
  • False (既定値):圧縮は使用されません。False (default value): Compression is not used.

RecoveryImagePartition

この設定は、Windows 10 で非推奨とされます。This setting is deprecated in Windows 10.

RecoveryImagePath

この設定は、Windows 10 で非推奨とされます。This setting is deprecated in Windows 10.

RecoveryImageIndex

この設定は、Windows 10 で非推奨とされます。This setting is deprecated in Windows 10.

WIMBoot

この設定は、Windows 10 で非推奨とされます。This setting is deprecated in Windows 10.

ResetConfig.xml を使用します。Using ResetConfig.xml

テキスト エディターを使用して、.xml ファイルを作成する場合は、.xml ファイル名の拡張子でドキュメントを保存および utf-8 エンコーディングを使用する必要があります。If you use a text editor to author your .xml files, you must save the document with an .xml file name extension, and use UTF-8 encoding. ANSI のコーディングを使用しないでください。You must not use ANSI coding.

これらのファイルは、c: フォルダーに配置する必要があります\Recovery\OEM、クリック 1 回のリセット機能によって自動的に検出されるとします。These files should be placed in the folder C:\Recovery\OEM, and will automatically be detected by Push-button reset features.

Example

これは、ResetConfig.xml ファイルのコード例です。This is a code example for the ResetConfig.xml file.

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

関連トピックRelated topics

クリック 1 回のリセットの概要Push-Button Reset Overview

クリック 1 回のリセット機能を実行するメディアを作成します。Create Media to Run Push-Button Reset Features