메인 콘텐츠로 건너뛰기
xbox context는 판매자, PlayFab 타이틀, XBOX 타이틀, 샌드박스의 기본값을 저장하므로 모든 명령에 이 값을 전달할 필요가 없습니다. 이 페이지에서는 값을 전달하지 않았을 때 명령이 이 값을 어디에서 가져오는지도 설명합니다. 컨텍스트는 로컬입니다. 이 명령은 Partner Center나 PlayFab에서 아무것도 변경하지 않습니다.

명령

키

키는 키가 채우는 옵션의 이름입니다. 그 밖의 옵션은 저장된 값이나 변수를 사용하지 않습니다. title-id는 1234ABCD와 같은 16진수 XBOX 타이틀 ID이며, PlayFab 타이틀 ID가 아닙니다. xbl 명령은 이 값을 사용하여 타이틀의 서비스 구성 식별자(SCID)를 찾으며, --scid를 전달하면 이 값을 무시합니다. 타이틀 지정을 참조하세요.

명령이 저장된 값을 사용하는 방식

명령이 이러한 옵션 중 하나를 사용하는 경우, 처음 찾은 값을 사용합니다.
  1. --seller-id와 같은 명령줄의 옵션.
  2. XBOX_SELLER_ID와 같은 옵션의 XBOX_ 변수. 비어 있는 변수는 설정되지 않은 것으로 간주합니다.
  3. 선택한 프로필에 context set으로 저장된 값.
변수나 저장된 컨텍스트의 값은 직접 입력한 값과 마찬가지로 검사되며, 오류에는 XBOX_SELLER_ID: --seller-id must be a positive numeric value.처럼 값의 출처가 표시됩니다. 명령에 필요한 값을 제공하는 곳이 없으면 값을 설정하는 방법을 알려 줍니다. 판매자가 선택 사항인 명령인 xbl과 test-account는 권한이 있는 유일한 판매자를 사용합니다. 무언가를 변경하는 명령은 --confirm을 사용하더라도 채운 각 값과 그 출처를 stderr에 씁니다. --verbose를 사용하면 모든 명령이 그렇게 합니다.
알려진 문제에서는 game 및 sandbox 명령이 이 방식으로 선택된 판매자와 다른 판매자를 사용하게 되는 두 가지 문제를 설명합니다.

프로필

프로필은 테스트 타이틀용과 프로덕션용처럼 이름이 지정된 저장된 값의 세트입니다. 명령은 --profile이 지정한 프로필을 사용하고, 없으면 XBOX_PROFILE이 지정한 프로필을, 그것도 없으면 default를 사용합니다.
셸의 모든 명령에 프로필을 사용하려면 XBOX_PROFILE을 설정하세요.
프로필을 나열하려면 다음을 실행합니다.
프로필과 그 프로필에 저장된 모든 값을 삭제하려면 다음을 실행합니다.
  • 프로필에 첫 번째 값을 저장하면 프로필이 생성됩니다. 이름은 문자, 숫자, 하이픈으로 최대 64자까지 사용할 수 있으며 대/소문자를 구분하지 않습니다.
  • 철자가 틀린 프로필처럼 존재하지 않는 프로필은 default로 대체되지 않고 실패합니다.
  • 프로필은 default의 값을 가져오지 않습니다.
  • XBOX_ 변수는 여전히 프로필보다 우선합니다. 변수가 --profile이 지정한 프로필보다 우선하면, 명령은 아무것도 변경하지 않더라도 이를 알려 줍니다.
  • CLI는 명령 간에 프로필을 기억하지 않으므로, 프로필을 선택해도 다른 터미널이나 에이전트가 사용하는 프로필은 바뀌지 않습니다.

값이 저장되는 위치

저장된 값은 CLI 상태 디렉터리의 context.json에 있습니다. 각 값은 값을 저장한 계정에 속하므로 다른 계정은 이 값을 사용하지 않습니다. auth logout은 저장된 값을 유지하며, 같은 계정으로 다시 로그인하면 값이 복원됩니다.

인수 및 옵션

동작

get은 로그인한 account, profile, 그리고 key와 value로 이루어진 values 배열을 반환하며, 저장되지 않은 키의 값은 null입니다. 이 명령은 명령이 사용할 값이 아니라 저장된 값을 보여 줍니다. 명령이 사용할 값을 보려면 해당 명령을 --verbose로 실행하세요. 로그아웃한 상태에서는 get이 값을 표시하지 않고 로그인 방법을 알려 줍니다. set, unset, profile 명령에는 로그인한 계정이 필요합니다. set은 서비스로 값을 확인하지 않으므로, 사용할 수 없는 판매자는 그 값을 보내는 첫 번째 명령에서 실패합니다. 서비스 주체에는 저장된 컨텍스트가 없습니다. 서비스 주체 모드에서는 로그인하는 명령이 --profile과 XBOX_PROFILE을 거부하고, key list를 제외한 모든 context 명령이 실패합니다. 대신 각 값을 해당 옵션이나 XBOX_ 변수로 전달하세요. 자동화(서비스 주체) 인증을 참조하세요.

명령줄에서 오지 않는 값

저장된 컨텍스트는 OS 사용자가 실행하는 모든 터미널과 에이전트에서 공유되며, 환경 변수는 명령줄에 나타나지 않습니다. 따라서 채운 각 값을 알려 주는 것 외에도 다음과 같이 동작합니다.
  • 대상이 컨텍스트 값 자체인 작업은 그 값이 명령줄에 있어야 합니다. /Admin/DeleteTitle은 타이틀을 삭제하고, playfab api-policy set --overwrite는 타이틀의 전체 API 액세스 정책을 대체하므로, 둘 다 저장된 컨텍스트나 변수에서 온 타이틀을 거부하고 대신 실행할 명령을 출력합니다.
    요청 본문에는 비밀이 포함될 수 있으므로, 출력된 명령에서는 인라인 --body 또는 --statements 값이 빠집니다. <body> 또는 <statements> 자리에 값을 다시 넣으세요.
  • 저장된 값을 사용하는 명령이 실행되는 동안(예: 확인을 기다리는 동안) 다른 계정이 로그인하면, 명령은 아무것도 보내기 전에 중지됩니다. 다시 실행하세요.
확인 규칙은 안전 및 파괴적 작업을 참조하세요.

테이블 출력

모든 context 명령은 --output table을 허용합니다.

예제

저장할 수 있는 키를 나열합니다.
판매자와 PlayFab 타이틀을 저장하고 저장된 내용을 확인합니다.
저장된 값을 사용하는 명령을 실행하고, 타이틀이 어디에서 왔는지 확인합니다.
저장된 값 하나를 제거합니다.
선택한 프로필에 저장된 모든 값을 제거합니다.
컨텍스트가 변경하지 않는 설정은 구성을 참조하세요.
마지막 수정일 2026년 11월 19일