메인 콘텐츠로 건너뛰기
XBOX CLI에는 구성 파일이 필요하지 않습니다. 설정은 실행 파일에 기본 제공된 기본값에서 가져오며, 환경 변수를 사용하여 셸에 대해 재정의하거나 옵션을 사용하여 단일 명령에 대해 재정의할 수 있습니다.

구성 원본 및 우선순위

설정은 세 가지 원본에서 가져오며, 나중 원본이 앞선 원본을 재정의합니다.
  1. 실행 파일에 컴파일된 기본 제공 기본값. 설정을 참조하세요.
  2. 환경 변수. 환경 변수를 참조하세요.
  3. 명령줄 옵션. CLI 옵션 재정의를 참조하세요.
새 릴리스에는 자체 기본값이 포함되므로 이어서 가져갈 설정 파일이 없습니다. 판매자, PlayFab 타이틀, XBOX 타이틀 및 샌드박스는 설정이 아닙니다. 명령이 이러한 값을 가져오는 위치는 컨텍스트를 참조하세요.

설정

  • AzureAd:*는 사용자 로그인을 구성합니다. 인증을 참조하세요.
  • PlayFab:StudioBaseUrl은 playfab service-principal이 호출하는 API와 같은 스튜디오 API(/Studio/*)의 PlayFab 엔드포인트입니다.
  • XboxPartner:TimeoutSeconds는 game과 같은 명령의 요청 시간 제한(초)이며, 양수여야 합니다.
  • XblPCSandbox:Path는 pc sandbox 명령이 실행하는 XblPCSandbox.exe입니다. 설정되지 않은 경우 CLI는 자체 디렉터리를 찾은 다음 PATH에서 찾습니다.
  • AuditLog:Enabled는 감사 로그를 켭니다.
  • Telemetry:*는 원격 분석에 설명되어 있습니다.
PlayFab:BaseUrlTemplate, PlayFab:StudioBaseUrl 또는 XboxPartner:BaseUrl이 기본 제공 기본값이 아니면, 해당 엔드포인트로 토큰을 보내는 모든 명령이 먼저 stderr에 경고를 작성합니다.

환경 변수

설정의 변수는 XBOX_와 해당 키로 구성되며, 각 :는 __(밑줄 두 개)로 바뀝니다. 따라서 Telemetry:Enabled는 XBOX_TELEMETRY__ENABLED입니다. 이름은 대문자로 작성하세요. 변수는 해당 변수를 설정한 셸과 해당 셸이 시작하는 모든 명령에 적용됩니다.
설정의 모든 설정에는 변수가 있습니다. CLI는 다음 변수도 읽습니다. XBOX_AUTHENTICATION__ 설정은 환경 변수에서만 읽으며, 기본 제공 기본값이나 옵션에서는 읽지 않습니다. 자동화(서비스 주체) 인증을 참조하세요.

CLI 옵션 재정의

옵션은 명령 하나에 대해 다른 모든 원본을 재정의합니다. 다른 전역 옵션은 명령을 참조하세요.

원격 분석 구성

공식 릴리스는 사용자가 끄지 않는 한 제한된 익명 원격 분석을 수집합니다. 명령 하나에 대해 끄려면 다음을 실행합니다.
셸에 대해 끄려면 다음을 실행합니다.
수집되는 항목은 원격 분석을 참조하세요.

appsettings.json을 읽던 릴리스에서 업그레이드

이전 릴리스는 실행 파일 옆에 있는 appsettings.json을 읽었습니다. 이 파일에서 값을 변경했다면 대신 해당 XBOX_ 변수를 설정하세요. 예를 들어 "AzureAd": { "ClientId": "..." }는 XBOX_AZUREAD__CLIENTID가 됩니다. 전환을 마칠 때까지 다음 메시지가 표시될 수 있습니다.
  • --config-env가 다음 오류와 함께 실패합니다. 이 옵션을 제거하고 대신 XBOX_ 변수를 설정하세요.
  • appsettings*.json 파일이 실행 파일 옆에 있는 동안 명령이 stderr에 다음 메모를 작성합니다. 파일을 삭제하세요.
  • 이전 오류 메시지에 따라 XBOX_PLAYFAB__REQUESTHEADERS__0__VALUE를 설정한 경우 PlayFab 명령이 해당 변수 이름을 명시하는 오류와 함께 실패합니다. 변수를 제거하세요.
마지막 수정일 2026년 11월 19일