恢复 (wdRecovery.exe) - XBOX Game Development Documentation

从 XBOX 网络、本地更新文件或可访问远程共享上托管的文件安装新的系统恢复。

命令	说明
install	安装主机恢复
live	从云端安装主机恢复
getversionid	获取当前已安装恢复的版本 ID,或分配给特定更新组(“LatestProduction”或“LatestPreview”)的恢复的版本 ID

wdRecovery install

通过从可访问的网络共享下载数据或使用本地文件来安装系统更新。要求 XBOX Live 授权此主机安装此更新。 wdRecovery install <updatePath> [/factoryreset] [/xblsandbox <sandboxId>] [/skipifequal]

选项	说明
`updatePath`	包含恢复文件的网络共享路径。
`factoryreset`	强制重置所有设置和内部存储。
`xblsandbox`	覆盖默认的 LIVE 沙盒。
`skipifequal`	如果主机已处于此版本的恢复,则跳过此更新并返回 0x8C11111D(不需要此恢复)。

wdrecovery live

通过从云端下载数据来安装系统更新,可通过版本 ID 指定,也可通过指定要为其安装分配给该组的恢复的特定更新组(LatestProduction 或 LatestPreview)指定。要求 XBOX Live 授权此主机安装此更新。

wdRecovery live <versionId> | LatestProduction | LatestPreview [/factoryreset] [/xblsandbox <sandboxId>] [/skipifequal] [/cdnoverride <URI>]

选项	说明
`versionId`	要安装的确切版本 ID(格式为 x.x.xxxx.x.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。您可以在 https://aka.ms/XboxRecoveryArchive 查看恢复列表
`factoryreset`	强制重置所有设置和内部存储。
`xblsandbox`	覆盖默认的 LIVE 沙盒。
`skipifequal`	如果主机已处于此版本的恢复,则跳过此更新并返回 0x8C11111D(不需要此恢复)。
`cdnoverride`	使用自定义 CDN 终结点覆盖 XBOX Live 返回的 CDN 值。使用此选项时建议提供版本 ID 参数。所有更新文件的完整路径必须如下所示:<CDN override value>.<Version ID of the build>/<Flat directory of update files>,例如 `http://example.com/xboxupdates/10.0.19041.6288.afaf9289-dc86-45ab-9515-02554081a1e8/*`

wdrecovery getversionid

获取当前运行的系统软件的版本 ID,或分配给特定更新组(LatestProduction 或 LatestPreview)的恢复的版本 ID。此输出可用作 “wdrecovery.exe live” 更新命令的版本 ID。 wdRecovery getversionid [LatestProduction | LatestPreview]

另请参阅

基于主机的命令行工具 XTF 传输错误

最后修改于 2026年8月24日

相关主题

基于主机的命令行工具面向 XBOX 的主机端命令行工具 XBOX PC Remote (wdRemote.exe)Remote Recovery URIs PFAccountManagementSendAccountRecoveryEmailRequest

⌘I