リモートリカバリー (xbremoterecovery.exe) - XBOX Game Development Documentation

このツールを使用して、XBOX One ファミリコンソールおよび XBOX Series コンソールでシステム更新を開始します。ローカル PC の宛先、XBOX services、またはカスタム CDN からシステム更新を取得できます。このツールでは、次のサブコマンドと機能を提供します。

コマンド	説明
xbremoterecovery install	PC からデータをダウンロードして Live システム更新をインストールします。コンソールが更新をインストールするには XBOX services による認可が必要です。
xbremoterecovery live	クラウドからデータをダウンロードして Live システム更新をインストールします。コンソールが更新をインストールするには XBOX services による認可が必要です。
xbremoterecovery getversion	現在コンソール上で実行されているシステムソフトウェアに関連付けられているバージョン番号を取得します。
xbremoterecovery getversionid	現在コンソール上で実行されているシステムソフトウェアに関連付けられているバージョン ID を取得します。
xbremoterecovery resetresume	進行中の更新をクリアし、次回の試行で新しい更新を開始できるようにします。

xbremoterecovery install

PC からデータをダウンロードして Live システム更新をインストールします。コンソールが更新をインストールするには XBOX services による認可が必要です。

列 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 services による認可が必要です。

列 1
xbremoterecovery live [VERSIONID] [/cdnoverride:VALUE]

オプション	説明
VERSIONID	インストールする正確なバージョン ID。形式は x.x.xxxx.x.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx です。開発キットが手動更新用に構成されている場合、VERSIONID は必須パラメーターです。それ以外の場合、このパラメーターを省略すると、その System Update Group で利用可能な最新バージョンに更新されます。VERSIONID の値は、次のいずれかの方法で確認できます。 1. https://aka.ms/gdkdl からダウンロードしたリカバリー .zip 内の update.ini ファイルを確認します。たとえば、2021 年 3 月 QFE 1 リカバリー更新のバージョン ID は次のとおりです: `VersionId=10.0.19041.6737.31cedb80-46ab-407b-b277-1c67bd056f4c` 2. `xbremoterecovery.exe` を `getversionid` コマンドラインスイッチで実行します。
/cdnoverride:VALUE	XBOX services が返す CDN 値をカスタム 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

現在コンソール上で実行されているシステムソフトウェアに関連付けられているバージョン ID を取得します。この ID は、xbremoterecovery live コマンドを実行する際の VERSIONID の値として使用できます。

列 1
xbremoterecovery getversionid

このトピックの先頭に戻る。

xbremoterecovery resetresume

進行中の更新をクリアし、次回の試行で新しい更新を開始できるようにします。

列 1
xbremoterecovery resetresume

場合によっては、リカバリーが失敗しても、更新が進行中であることを示すためにこのフラグが設定されたままになることがあります。このスイッチはこのフラグをクリアし、以降の更新を続行できるようにします。あるいは、コンソールを再起動してこのフラグをクリアすることもできます。このトピックの先頭に戻る。

​xbremoterecovery install

​xbremoterecovery live

​xbremoterecovery getversion

​xbremoterecovery getversionid

​xbremoterecovery resetresume

​関連項目

xbremoterecovery install

xbremoterecovery live

xbremoterecovery getversion

xbremoterecovery getversionid

xbremoterecovery resetresume

関連項目