> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 恢复 (wdRecovery.exe)

> 恢复 (wdRecovery.exe)

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

| 命令 | 说明 |
| - | - |
| [install](#wdrecovery_install) | 安装主机恢复 |
| [live]() | 从云端安装主机恢复 |
| [getversionid](#wdrecovery_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](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]`

## 另请参阅

[基于主机的命令行工具](https://docs.xbox.com/zh-CN/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)

[XTF 传输错误](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md)


## Related topics

- [基于主机的命令行工具](https://docs.xbox.com/zh-CN/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [面向 XBOX 的主机端命令行工具](https://docs.xbox.com/zh-CN/tools/tools-console/console_commandlinetools/index.md)
- [XBOX PC Remote (wdRemote.exe)](https://docs.xbox.com/zh-CN/tools/tools-pc/commandlinetools/gr-wdRemote.md)
- [Remote Recovery URI（API 内容）](https://docs.xbox.com/zh-CN/reference/deviceportal/remote/atoc-rest-remote.md)
- [发送自定义帐户恢复电子邮件](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/server/account-management/send-custom-account-recovery-email.md)