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

> 재현하기 어려운 저장 파일 문제를 디버깅할 수 있도록 RETAIL을 포함한 모든 샌드박스에서 XBOX 게임 저장 파일을 다운로드하는 명령줄 도구 XblConnectedStorage.exe입니다.

XBOX Connected Storage 도구는 게임 저장 파일을 다운로드하는 데 사용됩니다. RETAIL을 포함한
모든 샌드박스에서 저장 파일을 다운로드할 수 있습니다. 이는 재현하기 어려운 문제를 디버깅할 때 유용합니다.

이 명령줄 도구는 Microsoft Game Development Kit (GDK) 및 `XboxLiveTools.zip`의 일부입니다.
[XBOX services용 개발 도구](/tools/tools-services/live-tools)를 참조하세요. 버전 2104 이상의
GDK에서도 사용할 수 있습니다.

XblConnectedStorage.exe는 사용자의 연결된 저장소 데이터를 다운로드하는 데 사용됩니다. XBOX Connected Storage 도구를 사용하기 전에
개발자 계정으로 로그인하려면 [XBOX services 개발자 계정 도구 (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)와 함께 사용되도록 만들어졌으며,
XBOX Development Kit와 함께 사용하기 위해 XML 파일에서 연결된 저장 공간으로 데이터를 가져오는 데 사용할 수 있습니다. 이 도구는 gzip 압축된 저장 파일의 압축을 자동으로 해제합니다.

게임 저장에 대한 XML 파일을 가져오려면 세 가지 요구 사항이 있습니다.

1. Tools Access 권한에 대한 읽기 권한이 있는 개발자 계정. 자세히 알아보려면
   \[Connected Storage 도구를 사용하는 데 필요한 권한]\[#permissions-needed-to-use-the-tool]]에 대해 읽어보세요.
2. 타이틀의 Service Configuration ID (SCID). Partner Center에서 찾을 수 있습니다.
3. 저장을 가져올 사용자의 클래식 Gamertag.

#### 예제 명령줄 사용법.

```
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 Partner Center에서 [사용자 관리 페이지](https://partner.microsoft.com/dashboard/account/v3/usermanagement#users)를
   엽니다.
2. 권한을 확인하거나 수정할 사용자 또는 그룹을 선택합니다.
3. "권한 사용자 지정" 링크를 클릭합니다.
4. 권한을 확인하거나 수정할 제품을 선택합니다.
5. "XBOX Live"를 선택합니다.
6. "Tools Access"를 선택합니다.

해당 제품에 대한 게임 저장을 다운로드하려면 "Tools Access" 읽기 권한이 있는 개발자 계정이 필요합니다.

## 오류 메시지 이해

### 500 Internal Server Error

이 오류는 현재 개발자 계정이 액세스할 권한이 없는 SCID/샌드박스 조합에 액세스하려고 할 때 발생합니다.
이 문제를 해결하는 방법에 대한 지침은 이 문서의
[도구를 사용하는 데 필요한 권한](#permissions-needed-to-use-the-tool) 섹션을 참조하세요.


## Related topics

- [XBOX 서비스용 개발 도구](/ko/tools/tools-services/live-tools.md)
- [XBOX 서비스용 도구](/ko/tools/tools-services/live-tools-nav.md)
- [Connected Storage](/ko/services/xbox-services/storage/connected-storage/live-connected-storage-nav.md)
- [Player Data Reset 도구 (XblPlayerDataReset.exe)](/ko/tools/tools-services/live-player-data-reset.md)
- [Connected Storage 대 Title Storage](/ko/services/xbox-services/storage/live-connected-storage-vs-title-storage.md)