REAgentC Command-Line Options

Applies To: Windows 7

Note

This content applies to Windows 7. For Windows 8 content, see Windows Deployment with the Windows ADK.

REAgentC.exe is used for deploying custom Windows® Recovery Environment (Windows RE) as well as for enabling image recovery solutions.

You can run the REAgentC command on an offline Windows image or on a running Windows operating system.

If you are using Windows PE 2.X to configure recovery on an offline Windows® 7 image, use Winrecfg.exe from the Recovery folder of the Windows OEM Preinstallation Kit (Windows OPK). Winrecfg.exe supports only the offline operations that REAgentC.exe supports and is not included in the Windows Automated Installation Kit (Windows AIK).

REAgentC Commands

REAgentC uses the following conventions:

REAgentC {option} [argument]

Option Online/Offline Description

/setreimage/path<Windows_RE_location> [/target<offline_OS>] [/bootkey<scancode>]

Both

Stores the location of a custom Windows RE image in the currently running system or offline Windows 7 image. Once you specify a location, you can use the /enable option to enable Windows RE.

Use the /target argument to specify the location of the Windows 7 image when applying the setting offline:

reagentc /setreimage /path S:\Recovery\WindowsRE\ /target C:\Windows

The /bootkey argument specifies that when a key is pressed during startup, Windows RE and the custom recovery application launches:

reagentc /setreimage /path S:\Recovery\WindowsRE\ /target C:\Windows /bootkey 3b00

The following is a table of sample scan codes for different keys.

 

Key Scan code

F1

0x3b00

F2

0x3c00

F3

0x3d00

F4

0x3e00

F5

Do not use (reserved)

F6

0x4000

F7

0x4100

F8

Do not use (reserved)

F9

0x4300

F10

0x4400

F11

0x8500

F12

0x8600

For more information about customizing bootstrap actions, see Custom Bootstrap Actions.

/enable [/auditmode]

Online only

Enable any custom Windows RE specified by using the /setreimage option. If no recovery image is specified, the computer attempts to enable Windows RE by using the default Winre.wim from \Windows\System32\Recovery

By default, the /enable option does not do anything while Windows is in audit mode. To override this behavior and enable Windows RE from audit mode, specify the /auditmode argument. (If you generalize the image after using the /enable option in audit mode, Windows RE is disabled until you use the /enable option or until after OOBE.

/disable

Online only

Disable any active Windows RE mapped to the currently running Windows 7 system.

/boottore

Online only

Specify that the next time the system starts, Windows RE starts automatically.

/setosimage /path<recovery_image>|/customtool [/target<offline_OS>]

Both

When used with the /path argument, stores the location of a recovery image in the currently running system or offline Windows 7 image. The recovery image must be in the Windows image format and can be installed by using Windows Setup.

Alternatively, use the /customtool argument if you have added a custom recovery application to Windows RE.

Use the /target argument to specify the location of the Windows 7 image when applying the setting offline.

/info [/target<offline_OS>]

Both

Display the current status of Windows RE and any available recovery image on the currently running system or offline Windows 7 image. Use the /target argument to specify the location of the Windows 7 image when applying the setting offline.

See Also

Concepts

Windows Recovery Environment Technical Reference