Xbox 연결된 저장소 도구(XblConnectedStorage.exe)

아티클
05/09/2023

Xbox 연결된 저장소 도구는 게임 저장을 다운로드하는 데 사용됩니다. RETAIL을 비롯한 모든 샌드박스에서 다운로드할 수 있습니다. 이는 디버깅이 어려운 문제를 재현할 때 유용합니다.

이 명령줄 도구는 Microsoft 게임 개발 키트(GDK) 및 XboxLiveTools.zip의 일부입니다. Xbox 서비스용 개발 도구를 참조하세요. 버전 2104부터 GDK에서도 사용할 수 있습니다.

XblConnectedStorage.exe는 사용자의 연결된 스토리지 데이터를 다운로드하는 데 사용됩니다. Xbox 연결된 저장소 도구를 사용하기 전에 개발자 계정을 사용하여 로그인하려면 Xbox 서비스 개발자 계정 도구(XblDevAccount.exe)가 필요합니다.

사용 현황

연결된 저장소 도구를 사용하여 게임 저장을 나타내는 XML 파일을 가져오기 및 내보내기 파일 형식(NDA 주제)권한 부여 필요으로 가져올 수 있습니다. XML 파일은 xbstorage.exe 도구권한 부여 필요와 함께 사용하기 위한 것으로, Xbox 개발 키트에서 사용할 수 있도록 XML 파일의 데이터를 연결된 저장소 공간으로 가져오는 데 사용할 수 있습니다. 이 도구를 통해 압축 파일을 자동으로 해제할 수 있습니다.

게임 저장을 위해 XML 파일을 페치하려면 다음 세 가지 요구 사항이 필요합니다.

도구 액세스 권한에 대한 읽기 권한이 있는 개발자 계정이 있어야 합니다. 자세한 내용은 [연결된 저장소 도구를 사용하는 데 필요한 권한][#permissions-needed-to-use-the-tool]]을 참조하세요.
타이틀용 SCID(서비스 구성 ID)입니다. 이는 파트너 센터에서 확인할 수 있습니다.
저장을 위한 사용자의 클래식 게이머태그입니다.

명령줄 사용 예시입니다.

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

명령줄 옵션

도구에서 지원하는 사용 가능한 명령줄 옵션의 전체 목록을 보려면 --help 옵션을 사용합니다.

버전 2020.6.0.0을 기준으로, 출력은 다음과 같습니다.

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 연결된 저장소 도구를 사용하여 게임 저장 데이터에 액세스하려면 개발자 계정에 특정 권한이 필요합니다. 개발자 계정에 대한 사용 권한을 보거나 수정하려면 다음 단계를 수행합니다.

Microsoft 파트너 센터에서 사용자 관리 페이지를 엽니다.
사용 권한을 보거나 수정할 사용자 또는 그룹을 선택합니다.
"사용 권한 사용자 지정" 링크를 클릭합니다.
사용 권한을 보거나 수정할 제품을 선택합니다.
“XBOX Live"를 선택합니다.
“도구 액세스”를 선택합니다.

해당 제품에 대한 게임을 다운로드하려면 "도구 액세스" 읽기 권한이 있는 개발자 계정이 필요합니다.

오류 메시지 이해

500 내부 서버 오류

이 오류는 개발자 계정에 액세스할 수 있는 권한이 없는 SCID/샌드박스 조합에 액세스하려고 할 때 발생합니다. 이 문제의 해결 방법에 대한 지침은 이 문서의 도구 사용 시 필요한 사용 권한 섹션을 참조하세요.

다음을 통해 공유