메인 콘텐츠로 건너뛰기
XBOX CLI는 사용자의 권한으로, 종종 프로덕션 타이틀과 판매자를 대상으로 작동합니다. 이 페이지에서는 읽기만 하는 명령, 변경하기 전에 확인을 요청하는 명령, 이름만으로는 알 수 없는 작업을 수행하는 몇 가지 명령, 그리고 변경 결과를 알 수 없을 때 수행할 작업을 다룹니다. AI 에이전트가 변경 전에 확인해야 하는 사항은 에이전트에서 XBOX CLI 사용을 참조하세요. 명령은 플래그, XBOX_ 환경 변수 또는 xbox context set으로 저장된 값에서 타이틀, 판매자 또는 샌드박스를 가져옵니다. 무언가를 변경하는 명령은 명령줄에서 전달하지 않은 각 값을 stderr에 표시하므로, 프로덕션 변경 전에 이를 확인하세요. 컨텍스트를 참조하세요.

읽기 전용 항목

PlayFab 작업은 /Admin/GetTitleData 또는 /MultiplayerServer/ListBuildSummariesV2처럼 이름이 Get, List 또는 Search로 시작하는 경우에만 읽기 전용입니다. 그 밖의 모든 작업은 무언가를 변경합니다. 이는 명령 이름이 아니라 작업의 경로를 입력하는 xbox playfab api <api-path>에서 특히 중요합니다. 명령의 도움말에는 해당 명령이 무언가를 읽는지 변경하는지 알려 주는 SAFETY 섹션이 있습니다.

먼저 확인을 요청하는 항목

무언가를 변경하는 명령은 대부분 확인 없이 실행됩니다. 다음 명령은 터미널에서 먼저 확인을 요청하며, 터미널이 없으면 --confirm(--yes, -y)을 전달하지 않는 한 거부합니다.

명령 이름만으로는 알 수 없는 사항

  • playfab service-principal set이 실패하면 set이 성공할 때까지 서비스 주체가 스튜디오에 대한 액세스 권한을 갖지 못할 수 있으며, 이로 인해 해당 서비스 주체로 로그인하는 파이프라인이 중지될 수 있습니다. 다른 사람의 변경 사항을 덮어쓰지 않고 set이 실패하도록 --expected-version을 전달하세요.
  • playfab privacy export는 플레이어가 플레이한 게시자의 모든 타이틀에 대한 플레이어 데이터를 타이틀의 알림 이메일 주소로 보냅니다. 내보내기와 해당 이메일은 회수할 수 없습니다.
  • 다른 샌드박스에서의 xbl config publish는 대상의 전역 타이틀 스토리지 파일을 원본의 파일로 바꾸고, 대상에만 있는 파일을 삭제합니다. 삭제된 파일은 복구할 수 없습니다.
  • xbl config publish --sandbox-id HIDDEN은 RETAIL을 포함한 모든 샌드박스에서 사용하는 타이틀 전체 구성을 게시합니다.

중단된 쓰기는 결과를 알 수 없다고 보고함

CLI가 변경 사항을 보낸 후 Ctrl+C, 시간 초과 또는 연결 끊김 등으로 변경이 중단되거나, 서비스가 HTTP 5xx 오류로 응답하면 변경이 적용되었을 수 있습니다. 명령은 다음 PlayFab 오류처럼 결과를 알 수 없다고 표시합니다.
변경을 다시 실행하기 전에 영향을 받는 상태를 읽으세요. playfab 이외의 명령은 확인에 사용할 읽기 전용 명령을 출력합니다. CLI는 변경을 자동으로 다시 시도하지 않습니다. 작업을 기다리는 일부 명령은 요청이 수락되었지만 대기가 종료된 경우 4로 종료합니다. 명령을 다시 실행하지 마세요. 계속 기다리는 방법은 해당 명령의 페이지를 참조하세요.
마지막 수정일 2026년 11월 19일