REAgentC Command-Line Options
Applies To: Windows 8, Windows 8.1, Windows Server 2012, Windows Server 2012 R2
You can use the REAgentC.exe tool to configure a Windows® Recovery Environment (Windows RE) boot image and a push-button reset recovery image, and to administer recovery options and customizations. You can run the REAgentC command on an offline Windows image or on a running Windows operating system.
Note
If you are using Windows PE 2.X, 3.X, or 4.X to configure recovery on an offline Windows 8.1 or Windows Server 2012 R2 installation, you must use the Winrecfg.exe file from the Recovery folder of the Windows Assessment and Deployment Kit (Windows ADK). Winrecfg.exe supports only the offline operations that REAgentC.exe supports.
REAgentC Commands
The following command-line options are available for Windows RE:
reagentc.exe <command> <arguments>
The following table describes these command-line options:
Option | Online/Offline | Description |
---|---|---|
/setreimage /path<path_to_Windows_RE_image> [/target<path_to_offline_image>] |
Both |
Sets the location of a Windows RE boot image. In Windows 8.1, Windows 8 , Windows Server 2012 R2, and Windows Server 2012, /path supports UNC paths to locations on the local disk. For example:
Use the /target option to specify the location of the Windows image when you apply the setting offline. For example:
|
/enable [/auditmode] [/osguid <bcd_guid>] |
Online |
Enables a custom Windows RE boot image. The /enable option runs automatically during the specialize configuration pass. If you don't specify a Windows RE boot image, the computer attempts to enable Windows RE by using the default Winre.wim file from the \Windows\System32\Recovery folder.
|
/disable |
Online |
Disables any active Windows RE image that is mapped to the online image. For example:
|
/boottore |
Online |
Specifies that Windows RE starts automatically the next time the system starts. For example:
|
/setosimage /path<path_to_recovery_image>/index<image_index> [/target<path_to_offline_image>] |
Both |
Registers the location of a push-button reset image in an online or offline image. The recovery image must be in the Windows image (.wim) format. The /index option specifies the index number of the recovery image to use from within a .wim file. For example:
Use the /target option to specify the location of the offline Windows image. For example:
|
/info [/target<path_to_offline_image>] |
Both |
Displays the current status of Windows RE and any available recovery image on an online or offline image. For example, the following command returns the status of the online operating system:
Use the /target option to obtain configuration information about an offline image. For example:
|
/setbootshelllink [/configfile<path_to_BootShellXML>] [/target<path_to_offline_image>] |
Both |
Registers the link to a custom tool that appears in the Windows boot options menu. For example:
The BootShellXML file is an.xml file that contains the <BootShell> element and the <Name> and <Description> attributes that you want to appear in the link. For more information, see Customize Windows RE. Use the /target option to specify the location of the offline Windows image. If this argument is not used, the running operating system is used. For example:
|
See Also
Reference
Windows RE Troubleshooting Features
Concepts
Windows Recovery Environment (Windows RE) Overview