xbox 자체를 다룹니다. 아래의 각 명령에는 자체
페이지가 있으며, 각 playfab 서비스에는 commands/playfab/ 아래에 페이지가 있습니다.
터미널에서 동일한 참조를 보려면 xbox <command> --help를 실행하세요.
도움말은 CLI 계약이 변경되거나 제거될 수 있는 실험적 명령에 레이블을 표시합니다.
실험적 명령을 참조하세요.
핵심 명령
지원 명령
전역 옵션
모든 명령은 다음 옵션을 허용합니다. 표에 나와 있듯이 일부 옵션은 특정 명령에만 영향을 주며, 다른 명령에서는 허용되지만 무시됩니다.
옵션은 설정 및 환경 변수보다 우선합니다. 구성을 참조하세요.
출력 형식
데이터 명령은 결과를 stdout에, 오류 및 진단을 stderr에 작성합니다.
PlayFab 명령은 각 결과를
--data-only가 제거하는 응답 봉투로 래핑합니다.
응답 봉투를 참조하세요. --data-only는
다른 명령이나 --output table과 함께 사용할 때는 효과가 없습니다.
일부 명령은 JSON 대신 사람이 읽을 텍스트를 작성하며, 해당 페이지에 그렇게 명시되어 있습니다. auth status는
--output json 또는 --output json-compact를 전달하지 않으면 텍스트를 작성합니다.
Auth를 참조하세요. playfab file upload와 같은 파일 작업은
stdout에 아무것도 작성하지 않고 수행한 작업을 stderr에 보고합니다. 파일을 참조하세요.
표 출력
표는 터미널에서 읽기 위한 것입니다. 열은 어떤 릴리스에서든 변경될 수 있으므로 스크립트 및 에이전트는--output json-compact를 사용해야 합니다. 표 보기가 없는 명령은
table을 거부합니다.
진행률
game list처럼 여러 페이지를 읽거나 xbl config publish처럼 요청을 기다리는 명령은
stderr의 한 줄에 진행률을 표시합니다.
Reading games... 1646 found, 25 pages, 84s. 이 줄은 stderr가 터미널인 경우에만 표시되며,
결과가 나오기 전에 지워집니다.
종료 코드
다음 종료 코드는 모든 명령에서 공유됩니다. 무언가를 변경하는 명령은 변경 결과를 알 수 없을 때의3처럼
고유한 종료 코드를 추가할 수 있으며, 해당 페이지에 나열되어 있습니다.
실패한 PlayFab 호출은
--output 형식으로 오류 JSON을 stderr에 작성합니다.
PlayFab 오류 응답을 참조하세요. 알 수 없는 명령은 오류와
사용법을 stderr에 작성합니다. 도움말을 참조하세요.
명령이 변경 사항을 보낸 후 Ctrl+C를 누르면 변경이 적용되었을 수 있는지 여부를 stderr에
표시합니다. 해당 페이지에 문서화된 코드로 종료하며, PlayFab 명령의 경우 1로 종료합니다. 다시 실행하기 전에
확인하세요.
중단된 쓰기는 결과를 알 수 없다고 보고함을 참조하세요.
안전
많은 명령이 프로덕션 타이틀, 판매자 및 게임을 변경하며, 이름이Get, List 또는 Search로
시작하는 PlayFab 작업만 읽기 전용입니다. 무언가를 변경하는 명령을 실행하기 전에
안전 및 파괴적 작업을 읽어 보세요.