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

# XBOX Connected Storage ツール (XblConnectedStorage.exe)

> コマンドライン ツール XblConnectedStorage.exe。RETAIL を含む任意のサンドボックスから XBOX ゲーム セーブをダウンロードして、再現困難なセーブの問題をデバッグできます。

XBOX Connected Storage ツールは、ゲーム セーブをダウンロードするために使用します。RETAIL を含む
任意のサンドボックスからセーブをダウンロードできます。再現が困難な問題をデバッグする際に役立ちます。

このコマンド ライン ツールは Microsoft Game Development Kit (GDK) および `XboxLiveTools.zip` の一部です。
「[XBOX サービス用開発ツール](/tools/tools-services/live-tools)」を参照してください。バージョン 2104 以降の GDK にも
含まれています。

XblConnectedStorage.exe は、ユーザーの Connected Storage データをダウンロードするために使用します。
XBOX Connected Storage ツールを使用する前に、開発者アカウントでサインインするには
[XBOX サービス開発者アカウント ツール (XblDevAccount.exe)](/tools/tools-services/live-dev-account-tool) が必要です。

## 使用方法

Connected Storage ツールを使用して、[インポートおよびエクスポート ファイル形式 (NDA トピック)](/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat) で
ゲーム セーブを表す XML ファイルを取得できます。
この XML ファイルは、[xbstorage.exe ツール](/tools/tools-console/commandlinetools/xbstorage)での使用を想定しています。
xbstorage.exe を使用して、XML ファイルから XBOX Development Kit で使用する Connected Storage スペースに
データをインポートできます。ツールは gzip 圧縮されたセーブの解凍を自動的に処理します。

ゲーム セーブの XML ファイルを取得するには、3 つの要件があります。

1. Tools Access 権限の読み取り権限を持つ開発者アカウント。詳細については、
   \[Connected Storage ツールを使用するために必要な権限]\[#permissions-needed-to-use-the-tool]] を参照してください。
2. タイトルのサービス構成 ID (SCID)。これはパートナー センターで見つけることができます。
3. セーブを取得するユーザーのクラシック ゲーマータグ。

#### コマンド ラインの使用例。

```
XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe
```

#### コマンド ライン オプション

ツールがサポートする使用可能なコマンド ライン オプションの完全なリストを表示するには、`--help` オプションを使用します。

バージョン 2020.6.0.0 現在、出力は次のとおりです。

```shell theme={null}
XblConnectedStorage 2020.6.0.0
Copyright (C) 2021 Microsoft Corporation
USAGE:
Downloads the Connected Storage data for this user to ./output/xbstorage.xml:
XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe --output ./output/xbstorage.xml
 --sandbox TEST.0

  -c, --scid        Required. The service configuration ID (SCID) of the title

  -s, --sandbox     Required. The target sandbox for title storage

  -g, --gamertag    Required. The legacy gamertag of the player to retrieve storage for

  -o, --output      (Default: ./output/xbstorage.xml) The output file to write the xbstorage xml file to.

  --help            Display this help screen.

  --version         Display version information.
```

### ツールの使用に必要な権限

ユーザーのプライバシーとゲーム セーブ データを保護することは重要です。XBOX Connected Storage ツールを使用してゲーム
セーブ データにアクセスするには、開発者アカウントに特定の権限が必要です。開発者アカウントの権限を表示または変更する
には、次の手順に従います。

1. Microsoft パートナー センターの [ユーザー管理ページ](https://partner.microsoft.com/dashboard/account/v3/usermanagement#users) を開きます。
2. 権限を表示または変更したいユーザーまたはグループを選択します。
3. \[Customize Permissions] リンクをクリックします。
4. 権限を表示または変更したい製品を選択します。
5. \[XBOX Live] を選択します。
6. \[Tools Access] を選択します。

その製品のゲーム セーブをダウンロードするには、「Tools Access」の読み取り権限を持つ開発者アカウントが必要です。

## エラー メッセージについて

### 500 Internal Server Error

このエラーは、現在の開発者アカウントにアクセス権限がない SCID/サンドボックスの組み合わせにアクセス
しようとしたときに発生します。この問題を解決する方法については、このドキュメントの
[ツールの使用に必要な権限](#permissions-needed-to-use-the-tool)セクションを参照してください。


## Related topics

- [XBOX サービス向け開発ツール](/ja-jp/tools/tools-services/live-tools.md)
- [XBOX サービス向けツール](/ja-jp/tools/tools-services/live-tools-nav.md)
- [Player Data Reset ツール (XblPlayerDataReset.exe)](/ja-jp/tools/tools-services/live-player-data-reset.md)
- [Connected Storage](/ja-jp/services/xbox-services/storage/connected-storage/live-connected-storage-nav.md)
- [Global Storage ツール (GlobalStorage.exe)](/ja-jp/tools/tools-services/live-global-storage-tool.md)