메인 콘텐츠로 건너뛰기
playfab mps 명령 패밀리는 실험적 기능입니다. CLI 인터페이스는 피드백에 따라 변경되거나 제거될 수 있습니다. playfab mps는 PlayFab Multiplayer Servers(MPS)의 빌드와 그 별칭 및 지역, 서버, 자산, 인증서, 비밀, 컨테이너 이미지, 할당량, 가상 머신(VM)을 관리합니다. PlayFab의 MpsPowershell 모듈과 같은 작업을 다루며, 이 모듈의 Set-PfTitle에 해당하는 것은 xbox context set playfab-title-id <id>입니다. 컨텍스트를 참조하세요.

명령 트리

각 명령은 xbox playfab mps 아래에서 실행됩니다.

요청 본문

대부분의 MPS 명령은 playfab api처럼 작업의 JSON 요청 개체를 보냅니다. --body와 --body-file은 함께 사용할 수 없습니다. certificate upload와 secret upload는 --body-file만 사용하며, asset upload는 둘 다 사용하지 않습니다. 해당 섹션을 참조하세요.

파괴적 명령

다음 명령은 터미널에서는 먼저 묻고, 그 밖의 환경에서는 --confirm(--yes, -y)이 필요합니다. build delete, build alias delete, build region delete, server shutdown, asset delete, certificate delete, secret delete, container-image repository delete, remote-user delete. --body-file -를 사용하면 터미널에서도 --confirm이 필요합니다. 무언가를 변경하는 그 밖의 MPS 명령은 묻지 않고 실행됩니다. 안전 및 파괴적 작업을 참조하세요.

페이징

다음 목록 명령은 호출당 결과의 한 페이지를 반환합니다.
  • build list, build alias list
  • server list, server list-archived
  • asset list, certificate list, secret list
  • container-image list, container-image list-tags
  • virtual-machine list
결과가 더 있으면 응답의 SkipToken이 설정됩니다. 다음 페이지를 가져오려면 요청 본문에 그 값으로 "SkipToken"을 추가하고 다른 필드는 유지한 채, SkipToken이 null로 반환될 때까지 반복하세요. 한 페이지에 포함되는 결과 수를 변경하려면 요청 본문에 "PageSize"를 설정하세요. 빌드의 첫 번째 페이지를 가져옵니다.
SkipToken이 null이 아니면 해당 토큰을 전달하여 다음 페이지를 가져옵니다.
테이블 출력에는 SkipToken 열이 없으므로, 결과가 더 있으면 테이블 다음에 보낼 토큰이 포함된 알림이 stderr에 출력됩니다.

테이블 출력

다음 표의 명령은 --output table을 허용하며, 그 밖의 MPS 명령은 허용하지 않습니다. 테이블 출력을 참조하세요. 단일 레코드를 반환하는 명령은 레코드를 한 행으로 표시합니다. 가려진 열은 값이 자격 증명이므로 ********를 출력합니다. JSON 출력은 실제 값을 반환합니다.

mps build create

build create에는 호출할 PlayFab API를 선택하는 --type이 필요하며, 다른 MPS 명령처럼 요청 본문을 사용합니다.

mps certificate upload 및 mps secret upload

certificate upload와 secret upload는 요청 본문에 PFX 암호나 비밀 값이 들어 있으므로 --body-file <path> 또는 stdin의 경우 --body-file -로만 요청 본문을 받습니다. 셸 기록과 프로세스 목록에 값이 남는 --body는 거부합니다. 둘 다 --output table을 허용하지 않습니다. ForceUpdate는 같은 이름을 가진 기존 인증서나 비밀을 대체합니다. 본문 파일은 소스 제어에 포함하지 말고, 업로드한 후에는 삭제하세요. certificate.json에는 Base64로 인코딩된 PFX와 그 암호가 들어 있습니다.
비밀을 다른 파일에 쓰지 않고 본문을 만들려면 --body-file -로 파이프하세요. 여기서 jq는 자체 인수가 아니라 api-key.txt에서 값을 읽으므로, 값이 프로세스 목록에 나타나지 않습니다.

mps asset upload

asset upload는 로컬 파일을 멀티플레이어 서버 자산으로 업로드합니다. 요청 본문 대신 옵션을 사용하며, 자산 이름과 업로드 상태를 JSON으로 씁니다.
마지막 수정일 2026년 11월 19일