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

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

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

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

カスタムツールの追加

  1. 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 のカスタマイズ」を参照してください。

  2. メモ帳で、カスタム ツールのファイル名とパラメーター (ある場合) を指定する構成ファイルを作成します。

    <?xml version="1.0" encoding="utf-8"?>
    <!-- WinREConfig.xml -->
    <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 として保存します。

  3. 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 をアップグレードした後も引き続き機能するように、カスタム ツールとすべての関連フォルダーはこのフォルダーに含める必要があります。

  4. カスタマイズをコミットし、WinRE イメージのマウントを解除します。

    Dism /unmount-image /mountdir:C:\mount\winre /commit
    
  5. 省略可能: WinRE イメージのバックアップ コピーを作成します。

    copy C:\mount\windows\windows\system32\recovery\winre.wim C:\mount\winre_amd64_backup.wim
    

    多くの場合、複数のイメージで同じカスタマイズを再利用できます。

  6. Windows の基本イメージのマウントを解除し、変更を保存します。

    Dism /unmount-image /mountdir:C:\mount\windows /commit
    

イメージをデプロイする

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

    <?xml version="1.0" encoding="utf-8"?>
    <!-- AddDiagnosticsToolToBootMenu.xml -->
    <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:\ は、リムーバブル ドライブのドライブ文字またはネットワークの場所です。

  2. ターゲット コンピューターで、イメージの展開中、カスタムの WinRE ブート イメージと Windows オペレーティング システムを登録した後に、カスタム ツールの説明を登録する必要があります。

    Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
    

    カスタム ツールが正常に登録されると、このコマンドの実行後の出力は <OEM Tool = 1> になります。

    Note

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

Windows から起動した際に [PC の起動をカスタマイズする] メニューにカスタム ツールが表示されることを確認する

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

    Note

    プロダクト キーを求められた場合は、[スキップ] をクリックします。

  2. [設定]>[PC 設定] の順にクリックし、[全般] を選択します。

  3. [PC の起動をカスタマイズする] セクションの [今すぐ再起動] を選択します。

    Windows の [PC の起動をカスタマイズする] メニューが表示されます。

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

    コンピューターが WinRE で再起動し、WinREConfig.xml ファイルの <RecoveryTools> セクションで指定したツールが表示されます。

  5. カスタム ツールが正常に動作することを確認して、ツールを終了します。

    カスタム ツールが [PC の起動をカスタマイズする] メニューに表示されない場合は、次の操作をお試しください。

    • WinREConfig.xml と AddDiagnosticsToolToBootMenu.xml のファイルが UTF-8 エンコード形式を使用して保存されていることを確認します。

    • WinRE を無効にし、カスタム ツールをもう一度登録してから、WinRE を有効にします。 次に例を示します。

      Reagentc /disable 
      Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
      Reagentc /enable
      

WinRE の復旧メニューにカスタム ツールが表示されることを確認する

  1. 復旧メニューで [トラブルシューティング] を選択して、[Fabrikam ユーティリティ] リンクをクリックします。

  2. カスタム ツールが正常に動作することを確認して、ツールを終了します。

  3. [続行] をクリックします。

    PC がオペレーティング システムで再起動します。

Windows Recovery Environment (Windows RE) のテクニカル リファレンス

Windows RE のカスタマイズ

Windows RE の展開

Windows RE のトラブルシューティング機能