Customizing the Windows RE Experience

You can customize the user experience of Windows RE by creating an .xml file called WinREConfig.xml, which enables you to define custom support and diagnostic tools within Windows RE.

To customize the Windows RE experience

  1. Create a tools subdirectory in your working Windows RE directory. For example,

    \Sources\Recovery\Tools
    
  2. Create an .xml file called WinREConfig.xml, with the following syntax.

    <Recovery>
    <Server/>
    <RecoveryTools>
    <RelativeFilePath> Tools.exe</RelativeFilePath>
    </RecoveryTools>
    <SupportTool AutoLaunch=”Yes”/”No”>
    <RelativeFilePath> Tools.exe</RelativeFilePath>
    </SupportTool>
    <CustomFrontEnd>
    <RelativeFilePath> Tools.exe</RelativeFilePath>
    </CustomFrontEnd>
    <AlwaysAuthenticate/>
    <NonAdminToolsOnly/>
    <StartupRepair>
    <NoNetworking/>
    <NoAutoLaunchFromCD/>
    </StartupRepair>
    </Recovery>
    

    Choose the customizations that you intend to enable and include the corresponding elements in your WinREConfig.xml file. The following table describes these XML elements.

Element Description

Server

Sets Windows RE to run in server mode. When specified, client-specific Windows RE options are not displayed. This setting is required when installing Windows RE on a server system.

RecoveryTools

Link to the customized recovery application to be included in the System Recovery Options menu. Only one application can be specified. The icon shown is extracted from the first available icon in the application executable. The title and the description of the link are extracted from the "Product name" and "File description" attributes of the application executable file.

SupportTool

Denotes customized support or the diagnostic tool that can be launched from a link when Startup Repair is unable to repair the operating system. Only one tool can be specified.

AutoLaunch

Automatically launches the tool specified in SupportTool when the value is set equal to Yes. This setting does not apply to cases when no startup failure is detected or a hardware error is detected.

CustomFrontEnd

Specifies an application to be launched instead of the Windows RE default user interface (UI) unless one of the following is true. Windows RE is launched:

  • From CD/DVD.
  • Automatically.
  • From the F8 menu.

This application must set the registry value HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RecoveryEnvironment\TargetOS to the path of the Windows directory of Windows Vista.

This XML element is optional.

RelativeFilePath

The relative path from the \Tools subfolder of the folder in which Recenv.exe resides. For example, if Recenv.exe is located in X:\WinRE\, the path designated in this field is relative to X:\WinRE\tools.

AlwaysAuthenticate

Authentication is enforced, regardless of the start location of Windows RE, including media. If the username/password database on the offline Windows operating system is corrupt or otherwise inaccessible, users will not be able to access the recovery tools in Windows RE.

NonAdminToolsOnly

Only Startup Repair and the application specified in <RecoveryTools> (if present) is accessible through the Recovery menu. All other options are hidden.

StartupRepair

Contains a list of Startup Repair-specific settings.

NoNetworking

Disables the sending of diagnostic and repair data to Microsoft. Startup Repair will not turn on networking after a failed repair attempt.

NoAutoLaunchFromCD

Prevents Windows RE from launching Startup Repair automatically when it is booted from optical media and a boot failure in the offline operating system has been detected.

  1. Save the file in your working Windows RE directory under \Sources\Recovery\Tools.