xbox context는 판매자, PlayFab 타이틀, XBOX 타이틀, 샌드박스의 기본값을 저장하므로 모든
명령에 이 값을 전달할 필요가 없습니다. 이 페이지에서는 값을 전달하지 않았을 때 명령이 이
값을 어디에서 가져오는지도 설명합니다. 컨텍스트는 로컬입니다. 이 명령은 Partner Center나
PlayFab에서 아무것도 변경하지 않습니다.
명령
키
키는 키가 채우는 옵션의 이름입니다.
그 밖의 옵션은 저장된 값이나 변수를 사용하지 않습니다.
title-id는 1234ABCD와 같은 16진수 XBOX 타이틀 ID이며, PlayFab 타이틀 ID가 아닙니다.
xbl 명령은 이 값을 사용하여 타이틀의 서비스 구성 식별자(SCID)를 찾으며, --scid를
전달하면 이 값을 무시합니다. 타이틀 지정을 참조하세요.
명령이 저장된 값을 사용하는 방식
명령이 이러한 옵션 중 하나를 사용하는 경우, 처음 찾은 값을 사용합니다.--seller-id와 같은 명령줄의 옵션.XBOX_SELLER_ID와 같은 옵션의XBOX_변수. 비어 있는 변수는 설정되지 않은 것으로 간주합니다.- 선택한 프로필에
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을 허용합니다.
