カスタムツールを Windows RE Advanced スタートアップメニューに追加する

[アーティクル]
06/19/2023

カスタムのトラブルシューティングまたは診断ツールを Windows 回復環境 (WinRE) イメージに追加できます。このツールは、[PC の起動をカスタマイズする] メニューに表示されます。

WinRE で実行するカスタムツールを開発することで、WinRE で使用できるタッチおよびスクリーンキーボードのサポートを利用できます。

Windows 10 の新機能: 既定の WinRE ツールに含まれていない WinRE オプションコンポーネントを追加することはできません。たとえば、.NET のオプションのコンポーネントに依存する Windows 8 のアプリがある場合は、Windows 10 用にアプリを書き直す必要があります。

カスタムツールの追加

Windows イメージ (install.wim) とそれに対応する WinRE イメージ (winre.wim) を抽出してマウントします。

md c:\mount
xcopy D:\sources\install.wim C:\mount 
md C:\mount\windows
Dism /mount-image /imagefile:C:\mount\install.wim /index:1 /mountdir:C:\mount\windows 
md C:\mount\winre 
Dism /mount-image /imagefile:c:\mount\windows\windows\system32\recovery\winre.wim /index:1 /mountdir:C:\mount\winre

これらの手順の詳細については、「Windows RE のカスタマイズ」を参照してください。

メモ帳で、カスタムツールのファイル名とパラメーター (ある場合) を指定する構成ファイルを作成します。
```
<?xml version="1.0" encoding="utf-8"?>

<Recovery>
   <RecoveryTools>
      <RelativeFilePath>OEMDiagnostics.exe</RelativeFilePath>
      <CommandLineParam>/param1 /param2</CommandLineParam>
   </RecoveryTools>
</Recovery>
```
C:\Tools\OEMDiagnostics.exe は、カスタムのトラブルシューティングまたは診断ツールです。/param1 と /param2 は、このカスタムツールの実行時に使用するオプションのパラメーターです。

Note

WinRE の [PC の起動をカスタマイズする] メニューに追加できるカスタムツールは 1 つだけです。

UTF-8 コーディングを使用してファイルを保存します。 ANSI は使用しないでください。

[ファイル] をクリックして、[名前を付けて保存] をクリックします。 [エンコード] ボックスで [UTF-8] を選択し、このファイルを C:\mount\WinREConfig.xml として保存します。
WinRE マウントフォルダーに \Sources\Recovery\Tools フォルダーを作成し、カスタムツールとその構成ファイルを新しいフォルダーにコピーします。
```
md C:\mount\winre\sources\recovery\tools
copy C:\Tools\OEMDiagnostics.exe C:\mount\winre\sources\recovery\tools
copy C:\mount\WinREConfig.xml C:\mount\winre\sources\recovery\tools
```
将来 WinRE をアップグレードした後も引き続き機能するように、カスタムツールとすべての関連フォルダーはこのフォルダーに含める必要があります。
カスタマイズをコミットし、WinRE イメージのマウントを解除します。
```
Dism /unmount-image /mountdir:C:\mount\winre /commit
```
省略可能: WinRE イメージのバックアップコピーを作成します。
```
copy C:\mount\windows\windows\system32\recovery\winre.wim C:\mount\winre_amd64_backup.wim
```
多くの場合、複数のイメージで同じカスタマイズを再利用できます。
Windows の基本イメージのマウントを解除し、変更を保存します。
```
Dism /unmount-image /mountdir:C:\mount\windows /commit
```

イメージをデプロイする

メモ帳で、[PC の起動をカスタマイズする] メニューのカスタムツールについて説明する構成ファイルを作成します。サポートする各言語の説明を追加します。この例では、英語とフランス語の両方の言語バージョンのツール名と説明を指定します。
```
<?xml version="1.0" encoding="utf-8"?>

<BootShell>
   <WinRETool locale="en-us">
         <Name>Fabrikam Utility</Name>
         <Description>Troubleshoot your Fabrikam PC</Description>
   </WinRETool>
   <WinRETool locale="fr-fr">
      <Name>Utilité de Fabrikam</Name>
      <Description>Dépannez votre PC de Fabrikam</Description>
   </WinRETool>
</BootShell>
```
警告

[PC の起動をカスタマイズする] メニューに正しく表示されるように、<Name> と <Description> の値は約 30 文字以下に制限してください。

UTF-8 コーディングを使用してファイルを保存します。

[ファイル] をクリックして、[名前を付けて保存] をクリックします。 [エンコード] ボックスで [UTF-8] を選択し、このファイルを E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml として保存します。

E:\ は、リムーバブルドライブのドライブ文字またはネットワークの場所です。
ターゲットコンピューターで、イメージの展開中、カスタムの WinRE ブートイメージと Windows オペレーティングシステムを登録した後に、カスタムツールの説明を登録する必要があります。
```
Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
```
カスタムツールが正常に登録されると、このコマンドの実行後の出力は <OEM Tool = 1> になります。

Note

Windows の展開の詳細については、Windows RE の展開に関するトピックを参照してください。

ターゲットコンピューターを再起動し、ユーザーとして OOBE を完了します。

Note

プロダクトキーを求められた場合は、[スキップ] をクリックします。
[設定] > [PC 設定] の順にクリックし、[全般] を選択します。
[PC の起動をカスタマイズする] セクションの [今すぐ再起動] を選択します。

Windows の [PC の起動をカスタマイズする] メニューが表示されます。
[PC の起動をカスタマイズする] メニューで [トラブルシューティング] を選択して、[Fabrikam ユーティリティ] リンクをクリックします。

コンピューターが WinRE で再起動し、WinREConfig.xml ファイルの <RecoveryTools> セクションで指定したツールが表示されます。
カスタムツールが正常に動作することを確認して、ツールを終了します。

カスタムツールが [PC の起動をカスタマイズする] メニューに表示されない場合は、次の操作をお試しください。
- WinREConfig.xml と AddDiagnosticsToolToBootMenu.xml のファイルが UTF-8 エンコード形式を使用して保存されていることを確認します。
- WinRE を無効にし、カスタムツールをもう一度登録してから、WinRE を有効にします。次に例を示します。
```
Reagentc /disable 
Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
Reagentc /enable
```