> ## 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.

# 遠端復原 (xbremoterecovery.exe)

> 遠端復原 (xbremoterecovery.exe)

使用此工具在 XBOX One 系列主機與 XBOX Series 主機上起始系統更新。此工具可從本機 PC 目的地、XBOX 服務或自訂 CDN 取得系統更新。此工具提供下列子命令與功能。

| 命令 | 描述 |
| - | - |
| [xbremoterecovery install](#xbremoterecovery_install) | 從 PC 下載資料以安裝 Live 系統更新。XBOX 服務必須授權主機安裝更新。 |
| [xbremoterecovery live](#xbremoterecovery_live) | 從雲端下載資料以安裝 Live 系統更新。需要 XBOX 服務授權主機安裝更新。 |
| [xbremoterecovery getversion](#xbremoterecovery_getversion) | 擷取與主機上目前執行之系統軟體相關聯的版本號碼。 |
| [xbremoterecovery getversionid](#xbremoterecovery_getversionid) | 擷取與主機上目前執行之系統軟體相關聯的版本識別碼。 |
| [xbremoterecovery resetresume](#xbremoterecovery_resetresume) | 清除進行中的更新，讓下次嘗試時開始新的更新。 |

<a id="ID4EUC" />

<a id="xbremoterecovery_install" />

## xbremoterecovery install

從 PC 下載資料以安裝 Live 系統更新。XBOX 服務必須授權主機安裝更新。

| 欄 1 |
| - |
| \*\*xbremoterecovery install \*\**update\_path* \[/factoryreset\[:VALUE] ] \[/log] \[/noidletimeout] \[/xblsandbox:VALUE] \[/provision:\<path to xbProvision manifest>] \[/savehostname] \[/sethostname:NAME] \[/X\[:]*address\[+\<accesskey>]*] |

| 選項 | 描述 |
| - | - |
| *update\_path* | 包含系統更新資料檔案之目錄的路徑。 <br />例如 system.xvd、host.xvd、updater.xvd 與 update.ini。 |
| /factoryreset\[:VALUE] | 強制重設所有設定與內部儲存空間。<br />**無值**：將所有設定與內容完整重設為預設狀態。<br />**savesettings**：在出廠重設期間保留設定。 |
| /log | 產生適用於記錄檔的內容。 |
| /noidletimeout | 停用閒置關機計時器。這適用於測試使用者永遠不希望主機因閒置而自行關閉的情境。 |
| /xblsandbox:VALUE | 覆寫預設沙箱。這在第一次設定主機時特別實用，因為每部主機一開始都位於 RETAIL 沙箱，這對開發套件來說並不實際。第一次復原開發套件時必須使用此參數，以確保它進入正確的沙箱。 |
| /savehostname | 在降級組建且想要保留主機的主機名稱時使用此選項。將此選項與 /factoryreset 搭配使用可保留主機名稱。 |
| /sethostname:NAME | 類似 /savehostname，但會以提供的 NAME 覆寫主機名稱。 |
| /X\[:]*address\[+\<accesskey>]* | - 使用此選項可指定目標主機的主機名稱或位址 (在主機上顯示為 **Tools IP**)，而不需變更預設主機。如需為主機設定主機名稱的詳細資訊，請參閱[為主機 IP 位址設定主機名稱](/zh-TW/home/setup-install/dev-kit-settings/setting-a-hostname)。<br />- 如果您不使用此選項，則會使用預設主機 (先前由[連線 (xbconnect.exe)](/zh-TW/tools/tools-console/commandlinetools/xbconnect) 設定)。 <br />- 使用 *accesskey* 字串，只為擁有存取金鑰的人員提供主機存取權。 <br />- 使用 **xbconfig** **accesskey=your-key** 命令設定存取金鑰，然後重新啟動主機，讓存取金鑰生效。<br />- 若要存取已設定存取金鑰的主機，請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。<br />- 如果在使用 [xbconnect](/zh-TW/tools/tools-console/commandlinetools/xbconnect) 設定預設主機時提供了存取金鑰，該存取金鑰會儲存為預設主機位址的一部分。<br />- 如需存取金鑰的詳細資訊，請參閱 [xbconfig accesskey](/zh-TW/tools/tools-console/commandlinetools/xbconfig)。 |

[返回本主題頂端。](/zh-TW/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="xbremoterecovery_live" />

## xbremoterecovery live

從雲端下載資料以安裝 Live 系統更新。需要 XBOX 服務授權主機安裝更新。

| 欄 1 |
| - |
| **xbremoterecovery live \[VERSIONID] \[/cdnoverride:VALUE]** |

| 選項 | 描述 |
| - | - |
| VERSIONID | 要安裝的確切版本識別碼，格式為 x.x.xxxx.x.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。如果開發人員主機設定為手動更新，則 VERSIONID 為必要參數。否則，省略此參數會更新至其系統更新群組可用的最新版本。VERSIONID 值可透過下列其中一種方式決定：1. 檢查您從 [https://aka.ms/gdkdl](https://aka.ms/gdkdl) 下載的復原 .zip 中的 update.ini 檔案。例如，以下是 2021 年 3 月 QFE 1 復原更新的版本識別碼：`VersionId=10.0.19041.6737.31cedb80-46ab-407b-b277-1c67bd056f4c` 2. 以 `getversionid` 命令列參數執行 `xbremoterecovery.exe`。 |
| /cdnoverride:VALUE | 以自訂 CDN 端點覆寫 XBOX 服務傳回的 CDN 值。使用此選項時，建議提供 VERSIONID 參數。所有更新檔案的完整路徑必須如下所示： `\|----- 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/*` |

[返回本主題頂端。](/zh-TW/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="xbremoterecovery_getversion" />

## xbremoterecovery getversion

擷取與主機上目前執行之系統軟體相關聯的版本號碼。

| 欄 1 |
| - |
| \*\*xbremoterecovery getversion \*\* |

[返回本主題頂端。](/zh-TW/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="xbremoterecovery_getversionid" />

## xbremoterecovery getversionid

擷取與主機上目前執行之系統軟體相關聯的版本識別碼。執行 <a href="#xbremoterecovery_live">xbremoterecovery live</a> 命令時，可以使用此識別碼作為 VERSIONID 值。

| 欄 1 |
| - |
| \*\*xbremoterecovery getversionid \*\* |

[返回本主題頂端。](/zh-TW/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="xbremoterecovery_resetresume" />

## xbremoterecovery resetresume

清除進行中的更新，讓下次嘗試時開始新的更新。

| 欄 1 |
| - |
| \*\*xbremoterecovery resetresume \*\* |

在某些情況下，復原會失敗，但會保留此旗標的設定，表示更新正在進行中。此參數會清除此旗標，讓後續的更新得以繼續。您也可以選擇重新啟動主機來清除此旗標。

[返回本主題頂端。](/zh-TW/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="ID4ENBAC" />

## 另請參閱

[命令列工具](/zh-TW/tools/tools-console/commandlinetools/commandlinetools)

[XTF 傳輸錯誤](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)

[連線 (xbconnect.exe)](/zh-TW/tools/tools-console/commandlinetools/xbconnect)


## Related topics

- [主機開發的命令列工具](/zh-TW/tools/tools-console/commandlinetools/commandlinetools.md)
- [命令列工具](/zh-TW/tools/tools-console/commandlinetools/index.md)
- [遠端復原 URI](/zh-TW/reference/deviceportal/remote/atoc-rest-remote.md)
- [Windows Device Portal REST API 參考](/zh-TW/reference/deviceportal/atoc-deviceportal-reference.md)
- [復原 (wdRecovery.exe)](/zh-TW/tools/tools-console/console_commandlinetools/wdrecovery.md)