Was this page helpful?
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Add a Custom Tool to the Windows RE Boot Options Menu

Updated: October 20, 2013

Applies To: Windows 8.1, Windows Server 2012, Windows Server 2012 R2

You can add a custom troubleshooting or diagnostic tool to the Windows RE image. This tool is displayed in the Boot Options menu.

By developing your custom tool to run in Windows RE, you can leverage the touch and on-screen keyboard support available in Windows RE.

  1. Extract and mount a Windows image (install.wim) and its corresponding Windows RE image (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

    For more information about these steps, see the topic: Customize Windows RE.

  2. In Notepad, create a configuration file that specifies the custom tool’s filename and parameters (if any):

    <?xml version="1.0" encoding="utf-8"?>
    <!-- WinREConfig.xml -->
          <CommandLineParam>/param1 /param2</CommandLineParam>

    Where C:\Tools\OEMDiagnostics.exe is the custom troubleshooting or diagnostics tool, and where /param1 and /param2 are optional parameters used when running this custom tool.

    You can only add one custom tool to the Windows RE boot options menus.

    Save the file using UTF-8 coding. Do not use ANSI:

    Click File, and then click Save As. In the Encoding box, select UTF-8, and save this file as C:\mount\WinREConfig.xml

  3. Create a \Sources\Recovery\Tools folder in the Windows RE mount folder, and then copy the custom tool and its configuration file into the new folder:

    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
  4. Commit your customizations and unmount the Windows RE image:

    Dism /unmount-image /mountdir:C:\mount\winre /commit
  5. Optional: make a backup copy of the Windows RE image.

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

    You can often reuse the same customizations on multiple images.

  6. Unmount and save the changes from the base Windows image:

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

  1. In Notepad, create a configuration file that describes the custom tool in the boot options menu. Add descriptions for each language you support. This example specifies both English and French language versions of the tool name and description.:

    <?xml version="1.0" encoding="utf-8"?>
    <!-- AddDiagnosticsToolToBootMenu.xml -->
       <WinRETool locale="en-us">
             <Name>Fabrikam Utility</Name>
             <Description>Troubleshoot your Fabrikam PC</Description>
       <WinRETool locale="fr-fr">
          <Name>Utilité de Fabrikam</Name>
          <Description>Dépannez votre PC de Fabrikam</Description>
    Limit the <Name> and <Description> values to approximately 30 characters or less to make sure that they appear correctly in the boot options menu.

    Save the file using UTF-8 coding:

    Click File, and then click Save As. In the Encoding box, select UTF-8, and save this file as E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml

    Where E:\ is the drive letter of a removable drive or network location.

  2. On your destination computer, during image deployment, but after you register the custom Windows RE boot image and the Windows operating system, you must register the description of the custom tool:

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

    If the custom tool is registered properly, the output from running this command will be: <OEM Tool =  1>.

    For more information about deploying Windows, see the Deploy Windows RE topic.

  1. Restart the destination computer, and complete OOBE as your user.

    If you are prompted for a product key, click Skip.

  2. Click Start > PC settings, and then select General.

  3. In the Advanced startup section, select Restart now.

    The Windows Boot Options menu appears.

  4. In the Boot Options menu, select Troubleshoot, and then click the Fabrikam Utility link.

    The computer restarts in Windows RE, and the tool that is specified in the <RecoveryTools> section of the WinREConfig.xml file, appears.

  5. Confirm that the custom tool works properly, and then close the tool.

    If the custom tool does not appear on the Boot Options menu, you can try the following:

    • Verify the WinREConfig.xml and the AddDiagnosticsToolToBootMenu.xml files are saved using the UTF-8 encoding format.

    • Disable Windows RE, register the custom tool again, and then enable Windows RE. For example:

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

  1. In the recovery menu, select Troubleshoot, and then click the Fabrikam Utility link.

  2. Confirm that the custom tool works properly, and then close the tool.

  3. Click Continue.

    The PC reboots into the operating system.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft