> ## 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 services、またはカスタム CDN からシステム更新を取得できます。このツールでは、次のサブコマンドと機能を提供します。

| コマンド | 説明 |
| - | - |
| [xbremoterecovery install](#xbremoterecovery_install) | PC からデータをダウンロードして Live システム更新をインストールします。コンソールが更新をインストールするには XBOX services による認可が必要です。 |
| [xbremoterecovery live](#xbremoterecovery_live) | クラウドからデータをダウンロードして Live システム更新をインストールします。コンソールが更新をインストールするには XBOX services による認可が必要です。 |
| [xbremoterecovery getversion](#xbremoterecovery_getversion) | 現在コンソール上で実行されているシステム ソフトウェアに関連付けられているバージョン番号を取得します。 |
| [xbremoterecovery getversionid](#xbremoterecovery_getversionid) | 現在コンソール上で実行されているシステム ソフトウェアに関連付けられているバージョン ID を取得します。 |
| [xbremoterecovery resetresume](#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 アドレスにホスト名を設定する](/ja-jp/home/setup-install/dev-kit-settings/setting-a-hostname) を参照してください。 - このオプションを使用しない場合は、既定のコンソール（以前に [接続 (xbconnect.exe)](/ja-jp/tools/tools-console/commandlinetools/xbconnect) で設定されたもの）が使用されます。 - *accesskey* 文字列を使用して、アクセス キーを持つユーザーだけにコンソールへのアクセスを許可します。 - **xbconfig accesskey=your-key** コマンドでアクセス キーを設定し、コンソールを再起動してアクセス キーを有効にします。 - アクセス キーが設定されているコンソールにアクセスするには、コンソールの IP アドレスまたはホスト名の後にプラス記号 (+) とアクセス キーを付けます。 - [xbconnect](/ja-jp/tools/tools-console/commandlinetools/xbconnect) で既定のコンソールを設定する際にアクセス キーを指定した場合、そのアクセス キーは既定のコンソールのアドレスの一部として保存されます。 - アクセス キーの詳細については、[xbconfig accesskey](/ja-jp/tools/tools-console/commandlinetools/xbconfig) を参照してください。 |

[このトピックの先頭に戻る。](/ja-jp/tools/tools-console/commandlinetools/xbremoterecovery)

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

[このトピックの先頭に戻る。](/ja-jp/tools/tools-console/commandlinetools/xbremoterecovery)

## xbremoterecovery getversion

現在コンソール上で実行されているシステム ソフトウェアに関連付けられているバージョン番号を取得します。

| 列 1 |
| - |
| \*\*xbremoterecovery getversion \*\* |

[このトピックの先頭に戻る。](/ja-jp/tools/tools-console/commandlinetools/xbremoterecovery)

## xbremoterecovery getversionid

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

| 列 1 |
| - |
| \*\*xbremoterecovery getversionid \*\* |

[このトピックの先頭に戻る。](/ja-jp/tools/tools-console/commandlinetools/xbremoterecovery)

## xbremoterecovery resetresume

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

| 列 1 |
| - |
| \*\*xbremoterecovery resetresume \*\* |

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

[このトピックの先頭に戻る。](/ja-jp/tools/tools-console/commandlinetools/xbremoterecovery)

## 関連項目

[コマンドライン ツール](/ja-jp/tools/tools-console/commandlinetools/commandlinetools)

[XTF トランスポート エラー](/ja-jp/tools/tools-console/commandlinetools/xtf-transport-errors)

[接続 (xbconnect.exe)](/ja-jp/tools/tools-console/commandlinetools/xbconnect)


## Related topics

- [リモート リカバリー URI (API の内容)](/ja-jp/reference/deviceportal/remote/atoc-rest-remote.md)
- [リカバリー (wdRecovery.exe)](/ja-jp/tools/tools-console/console_commandlinetools/wdrecovery.md)
- [Windows Device Portal REST API リファレンス (API の内容)](/ja-jp/reference/deviceportal/atoc-deviceportal-reference.md)
- [コンソール ベースのコマンドライン ツール](/ja-jp/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [コンソール開発用のコマンド ライン ツール](/ja-jp/tools/tools-console/commandlinetools/commandlinetools.md)
