I have tested the
reagentc /setreimage command multiple times in a virtual machine and confirmed that the default Windows RE configuration can be restored by:
1. Disable Windows RE (
reagentc /disable).
2. Manually move
Winre.wim to
C:\Windows\System32\Recovery if it is not already there.
3. Delete the Windows RE configuration file (
del C:\Windows\System32\Recovery\ReAgent.xml).
4. Re-enable Windows RE (
reagentc /enable), allowing Windows to recreate the default Windows RE configuration.
Note:
reagentc /setreimage changes the
configured staging location stored in
ReAgent.xml, which in turn changes how
reagentc /enable and
reagentc /disable behave.
The following summary shows how
reagentc /setreimage changes Windows RE behavior by configuring a custom staging location.
Windows RE behavior with the default and custom staging locations
reagentc /enable
With the default Windows RE configuration:
- Searches for a suitable recovery partition.
- Moves
Winre.wim from the default staging location (C:\Windows\System32\Recovery) to the recovery partition (or to C:\Recovery\WindowsRE if no suitable recovery partition exists).
- Updates
ReAgent.xml to enable Windows RE and record the registered Windows RE location.
If a custom staging location has been configured:
- reagentc /setreimage /path R:\Recovery\WindowsRE
If the recovery partition (the configured staging location) meets the Windows RE requirements, reagentc /enable keeps Winre.wim on that partition instead of searching for another suitable recovery partition.
- reagentc /setreimage /path C:\Windows\System32\Recovery
reagentc /enable moves Winre.wim from the configured staging location (C:\Windows\System32\Recovery) to C:\Recovery\WindowsRE on the Windows partition instead of to the recovery partition.
- Updates
ReAgent.xml to enable Windows RE and record the registered Windows RE location.
reagentc /disable
With the default Windows RE configuration:
- Moves
Winre.wim from the active Windows RE location (normally the recovery partition) to the default staging location (C:\Windows\System32\Recovery).
- Updates
ReAgent.xml to disable Windows RE. The registered Windows RE location is cleared.
If a custom staging location has been configured:
- reagentc /setreimage /path R:\Recovery\WindowsRE
reagentc /disable keeps Winre.wim on the configured staging location instead of moving it elsewhere.
- reagentc /setreimage /path C:\Windows\System32\Recovery
reagentc /disable moves Winre.wim from the active Windows RE location (C:\Recovery\WindowsRE) to the configured staging location (C:\Windows\System32\Recovery).
- Updates
ReAgent.xml to disable Windows RE. The registered Windows RE location is cleared, but the configured staging location is retained.
How the Windows RE configuration is stored in ReAgent.xml
Windows RE enabled
Default staging location (
C:\Windows\System32\Recovery):
Code:
<WinreLocation path="\Recovery\WindowsRE" id="0" offset="997691752448" guid="{3122a9fd-d56a-45f8-a196-e134970f22dc}"/>
<ImageLocation path="" id="0" offset="0" guid="{00000000-0000-0000-0000-000000000000}"/>
<WinREStaged state="0"/>
Custom staging location (
reagentc /setreimage /path R:\Recovery\WindowsRE):
Code:
<WinreLocation path="\Recovery\WindowsRE" id="0" offset="997691752448" guid="{3122a9fd-d56a-45f8-a196-e134970f22dc}"/>
<ImageLocation path="\Recovery\WindowsRE" id="0" offset="997691752448" guid="{3122a9fd-d56a-45f8-a196-e134970f22dc}"/>
<WinREStaged state="0"/>
Windows RE disabled
As the
ReAgent.xml examples below show, the
reagentc /disable command clears the registered Windows RE location. If a custom staging location has been configured using
reagentc /setreimage, the configured staging location is retained.
Default staging location (
C:\Windows\System32\Recovery):
Code:
<WinreLocation path="" id="0" offset="0" guid="{00000000-0000-0000-0000-000000000000}"/>
<ImageLocation path="" id="0" offset="0" guid="{00000000-0000-0000-0000-000000000000}"/>
<WinREStaged state="0"/>
Custom staging location (
reagentc /setreimage /path R:\Recovery\WindowsRE):
Code:
<WinreLocation path="" id="0" offset="0" guid="{00000000-0000-0000-0000-000000000000}"/>
<ImageLocation path="\Recovery\WindowsRE" id="0" offset="997691752448" guid="{3122a9fd-d56a-45f8-a196-e134970f22dc}"/>
<WinREStaged state="1"/>
ChatGPT:
Based on your testing, I think these three elements can be described quite accurately, even though Microsoft doesn't formally document them. I'd be careful to present them as
observed behavior rather than official definitions.
Putting the three elements together:
- <WinreLocation> — Where Windows RE is currently registered and booted from.
- <ImageLocation> — Where ReAgentC stores or expects the staged
Winre.wim image (the configured staging location).
- <WinREStaged> — A temporary state flag indicating that a staged Windows RE image is present while Windows RE is disabled.
I think this interpretation best fits all four of your
ReAgent.xml examples. In particular, it explains why:
- <WinreLocation> is cleared by
reagentc /disable.
- <ImageLocation> is retained only when you've configured a custom staging location.
- <WinREStaged> changes to 1 only while Windows RE is disabled with a custom staging location, then returns to 0 after
reagentc /enable completes.
reagentc /setreimage is primarily intended for deployment and customization scenarios where
Winre.wim is stored in a custom (non-default) location.
Code:
@echo == Register the location of the recovery tools ==
W:\Windows\System32\Reagentc /Setreimage /Path R:\Recovery\WindowsRE /Target W:\Windows
In this example, the Windows installation is offline (
W:\Windows), and the recovery image is being explicitly registered at
R:\Recovery\WindowsRE. The
/Target parameter causes
ReAgentC to modify the
ReAgent.xml file of the offline Windows installation located at
W:\Windows, not the
ReAgent.xml file of the currently running Windows installation. As a result, the offline installation is configured to use
R:\Recovery\WindowsRE as its Windows RE image location.
That's quite different from a normal installed system, where
reagentc /enable automatically locates and registers
Winre.wim.
