REAgentC 命令行选项

可以使用 REAgentC.exe 工具来配置 Windows 恢复环境 (Windows RE) 启动映像和按钮重置恢复映像,以及管理恢复选项和自定义项。 REAgentC 随 Windows 一起提供,您可以在脱机 Windows 映像或正在运行的 Windows 操作系统上运行 REAgentC 命令。

注意

如果使用 Windows PE 2.X、3.X 或 4.X 在脱机安装上配置恢复,必须使用 Windows 评估和部署工具包 (Windows ADK) 的 Recovery 文件夹中的 Winrecfg.exe 文件。 Winrecfg.exe 只支持 REAgentC.exe 支持的脱机操作。

REAgentC 语法

reagentc.exe <command> <arguments>

/setreimage

设置 Windows RE 启动映像的位置。

支持联机和脱机操作。

/setreimage 语法

/setreimage /path <path_to_Windows_RE_image> [/target <path_to_offline_image>]

/setreimage 用法

  • /path 支持本地磁盘上位置的 UNC 路径。 例如:

    Reagentc /setreimage /path S:\Recovery\WindowsRE`
    
  • /target 指定在脱机应用设置时 Windows 映像的位置。 例如:

    Reagentc /setreimage /path T:\Recovery\WindowsRE /target W:\Windows
    

/enable

启用自定义 Windows RE 启动映像。

/enable 选项在 specialize 配置传送过程中自动运行。 如果未指定 Windows RE 启动映像,计算机会尝试通过使用 \Windows\System32\Recovery 文件夹中的默认 Winre.wim 文件来启用 Windows RE。

支持联机和脱机操作。

/enable 语法

/enable [/auditmode] [/osguid <bcd_guid>]

/enable 用法

  • /auditmode:在默认情况下,当 Windows 处于审核模式下时,/enable 选项不执行任何操作。 若要替代默认行为并从审核模式启用 Windows RE,请指定 /auditmode 选项。 例如:

    Reagentc /enable /auditmode
    

    如果在审核模式下使用 /enable 选项后通用化该映像,Windows RE 就会被禁用,直至再次使用 /enable 选项或直至 specialize 配置传送运行之后。

  • /osguid {<bcd_guid>} 允许从 Windows PE 启用自定义 Windows RE 启动映像。 它只能在已经运行了 bcdboot.exe 之后使用。 <bcd_guid> 是目标 Windows 安装的引导配置数据 (BCD) 标识符,是通过运行 bcdedit -enum -v 获取的。

    Reagentc /enable /osguid {00000000-0000-0000-0000-000000000000}
    

/disable

禁用任何映射到联机映像的活动 Windows RE 映像。

只支持联机操作。

/disable 用法

Reagentc /disable

/boottore

指定 Windows RE 在下次系统启动时自动启动。

只支持联机操作。

/boottore 用法

Reagentc /boottore

/setosimage

此设置不用于 Windows 10 或更高版本

在联机或脱机映像中注册按钮重置映像的位置。 恢复映像必须采用 Windows 映像 (.wim) 格式。

支持联机和脱机操作。

/setosimage 语法

/setosimage /path <path_to_recovery_image> /index <image_index> [/target <path_to_offline_image>]

/setosimage 用法

  • /index 选项指定要从 .wim 文件中使用的恢复映像的索引号。 例如:

    Reagentc /setosimage /path R:\RecoveryImage /index 1
    
  • /target 选项指定脱机 Windows 映像的位置。 例如:

    Reagentc /setosimage /path R:\RecoveryImage /index 1 /target W:\Windows
    

/info

显示联机或脱机映像上 Windows RE 和任何可用恢复映像的当前状态。

支持联机和脱机操作。

/info 语法

/info [/target <path_to_offline_image>]

/info 用法

  • /info 自行返回联机操作系统的状态:

    Reagentc /info
    
  • /target 选项获取有关脱机映像的配置信息。 例如:

    Reagentc /info /target W:\Windows
    

将链接注册到 Windows 高级启动菜单中显示的自定义工具。

支持联机和脱机操作。

/setbootshelllink [/configfile <path_to_BootShellXML>] [/target <path_to_offline_image>]
  • BootShellXML 文件是一个 xml 文件,其中包含要在链接中显示的 <BootShell> 元素以及 NameDescription 属性。 有关详细信息,请参阅自定义 Windows RE

    Reagentc /setbootshelllink /configfile F:\BootMenu\AddDiagnosticsToolToBootMenu.xml
    
  • /target 选项指定脱机 Windows 映像的位置。 如果未使用此参数,则会使用正在运行的操作系统。 例如:

    Reagentc /setbootshelllink /target W:\Windows
    

Windows RE 故障排除功能