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: The /bootkey argument specifies that when a key is pressed during startup, Windows RE and the custom recovery application launches: The following is a table of sample scan codes for different keys.
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. |