> ## 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 連線儲存空間工具 (XblConnectedStorage.exe)

> 命令列工具 XblConnectedStorage.exe，可從任何沙箱 (包括 RETAIL) 下載 XBOX 遊戲存檔，協助對難以重現的存檔問題進行偵錯。

XBOX 連線儲存空間工具用於下載遊戲存檔。它可以從任何沙箱 (包括 RETAIL) 下載存檔。這在對難以重現的問題進行偵錯時很有幫助。

此命令列工具是 Microsoft Game Development Kit (GDK) 與 `XboxLiveTools.zip` 的一部分；請參閱
[XBOX 服務的開發工具](/zh-TW/tools/tools-services/live-tools)。從 2104 版開始，GDK 中也提供此工具。

XblConnectedStorage.exe 用於下載使用者的連線儲存空間資料。使用 XBOX 連線儲存空間工具之前，必須先使用
[XBOX 服務開發者帳戶工具 (XblDevAccount.exe)](/zh-TW/tools/tools-services/live-dev-account-tool) 以開發者帳戶登入。

## 使用方式

連線儲存空間工具可用於擷取一個 XML 檔案，以[匯入與匯出檔案格式 (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat) 呈現遊戲存檔。
此 XML 檔案是供 [xbstorage.exe 工具)](/zh-TW/tools/tools-console/commandlinetools/xbstorage) 使用，
該工具可用於將 XML 檔案中的資料匯入連線儲存空間，以搭配 XBOX Development Kit 使用。此工具會自動處理 gzip 壓縮存檔的解壓縮。

擷取遊戲存檔的 XML 檔案有三項需求：

1. 具有 Tools Access 權限之讀取權限的開發者帳戶。若要深入了解，
   請參閱\[使用連線儲存空間工具所需的權限]\[#permissions-needed-to-use-the-tool]]。
2. 遊戲的服務設定識別碼 (SCID)。這可以在 Partner Center 中找到。
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.
```

<a id="permissions-needed-to-use-the-tool" />

### 使用此工具所需的權限

保護使用者與遊戲存檔資料的隱私權十分重要。開發者帳戶需要特定權限，才能使用 XBOX 連線儲存空間工具存取遊戲存檔資料。若要檢視或修改開發者帳戶的這些權限，請依照下列步驟執行：

1. 在 Microsoft Partner Center 中開啟[使用者管理頁面](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 服務的開發工具](/zh-TW/tools/tools-services/live-tools.md)
- [XBOX 服務的工具](/zh-TW/tools/tools-services/live-tools-nav.md)
- [全域儲存空間工具 (GlobalStorage.exe)](/zh-TW/tools/tools-services/live-global-storage-tool.md)
- [玩家資料重設工具 (XblPlayerDataReset.exe)](/zh-TW/tools/tools-services/live-player-data-reset.md)
- [連線儲存空間](/zh-TW/services/xbox-services/storage/connected-storage/live-connected-storage-nav.md)