> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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 |

<a id="wdrecovery_install" />

## wdRecovery install

通过从可访问的网络共享下载数据或使用本地文件来安装系统更新。要求 XBOX Live 授权此主机安装此更新。

`wdRecovery install <updatePath> [/factoryreset] [/xblsandbox <sandboxId>] [/skipifequal]`

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

<a id="wdRecovery_live" />

## 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/*` |

<a id="wdrecovery_getversionid" />

## wdrecovery getversionid

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

`wdRecovery getversionid [LatestProduction | LatestPreview]`

## 另请参阅

[基于主机的命令行工具](/tools/tools-console/console_commandlinetools/consolecommandlinetools)

[XTF 传输错误](/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [基于主机的命令行工具](/zh-CN/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [面向 XBOX 的主机端命令行工具](/zh-CN/tools/tools-console/console_commandlinetools/index.md)
- [XBOX PC Remote (wdRemote.exe)](/zh-CN/tools/tools-pc/commandlinetools/gr-wdRemote.md)
- [Remote Recovery URIs](/zh-CN/reference/deviceportal/remote/atoc-rest-remote.md)
- [PFAccountManagementSendAccountRecoveryEmailRequest](/zh-CN/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementsendaccountrecoveryemailrequest.md)