遠端復原 (xbremoterecovery.exe) - XBOX Game Development Documentation

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

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

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

返回本主題頂端。

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 下載的復原 .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/*`

返回本主題頂端。

xbremoterecovery getversion

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

欄 1
xbremoterecovery getversion

返回本主題頂端。

xbremoterecovery getversionid

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

欄 1
xbremoterecovery getversionid

返回本主題頂端。

xbremoterecovery resetresume

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

欄 1
xbremoterecovery resetresume

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

另請參閱

命令列工具 XTF 傳輸錯誤連線 (xbconnect.exe)

​xbremoterecovery install

​xbremoterecovery live

​xbremoterecovery getversion

​xbremoterecovery getversionid

​xbremoterecovery resetresume

​另請參閱

xbremoterecovery install

xbremoterecovery live

xbremoterecovery getversion

xbremoterecovery getversionid

xbremoterecovery resetresume

另請參閱