메인 콘텐츠로 건너뛰기
xbox auth는 다른 명령이 사용하는 Microsoft Entra ID 계정을 관리합니다. 서비스 주체로 로그인하는 방법을 포함하여 로그인이 작동하는 방식은 인증을 참조하세요.
--output table을 허용하는 auth 명령은 없습니다. XBOX_AUTHENTICATION__MODE가 서비스 주체 모드를 선택하면 auth login과 auth logout은 1로 종료되고, auth status는 서비스 주체를 설명합니다.

auth login

Microsoft Entra ID로 로그인하며, 이미 로그인한 계정을 대체합니다.
이 명령은 시스템 브라우저를 열고, 성공하면 계정과 해당 토큰이 만료되는 시점을 출력합니다. 이후의 모든 명령은 해당 계정을 사용합니다. 예를 들어 이전 CLI 버전으로 인해 둘 이상의 계정이 캐시되어 있으면 auth login을 다시 실행할 때까지 명령이 실패합니다.

auth logout

캐시된 모든 계정에서 로그아웃합니다.
이 명령은 로그아웃한 계정을 출력하거나, 로그인한 계정이 없었음을 출력합니다. context set으로 저장한 값은 유지되며, 같은 계정으로 다시 로그인하면 복원됩니다.

auth status

로그인한 계정과 해당 토큰을 표시합니다. 이 명령은 Entra ID로 토큰을 새로 고칠 수 있지만 토큰을 사용하지는 않으므로, 다른 명령이 토큰을 허용할지는 확인하지 않습니다. 저장된 판매자와 PlayFab 타이틀을 보려면 xbox context get을 실행하세요.
--output을 전달하지 않으면 출력은 텍스트입니다. 스크립트에서는 JSON을 요청하고 signedIn을 확인하세요.

서비스 주체 모드

서비스 주체 모드에서 auth status는 앱 전용 토큰을 가져와 해당 클레임을 보고합니다. 토큰 자체는 절대 출력하지 않습니다.
서비스 주체 또는 관리 ID의 경우 principalType은 app입니다. ID 확인을 참조하세요.
마지막 수정일 2026년 11월 19일