メインコンテンツへスキップ
playfab mps コマンド ファミリーは試験段階 (Experimental) です。CLI インターフェイスは、フィードバックに基づいて変更または 削除される可能性があります。 playfab mps は、PlayFab のマルチプレイヤー サーバー (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 コマンドは、確認を求めずに 実行されます。安全性と破壊的な操作を参照してください。

ページング

次の list コマンドは、呼び出しごとに結果を 1 ページ返します。
  • 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 で返されるまで繰り返します。1 ページに含める結果の数を変更するには、リクエスト本文で "PageSize" を設定します。 ビルドの最初のページを取得します。
SkipToken が null でない場合は、そのトークンを渡して次のページを取得します。
テーブル出力には SkipToken の列がないため、さらに結果がある場合は、テーブルの後に、 送信するトークンを含む通知が stderr に出力されます。

テーブル出力

次の表に示すコマンドは --output table を受け付けます。その他の MPS コマンドは受け付けません。 テーブル出力を参照してください。 単一のレコードを返すコマンドは、そのレコードを 1 行で表示します。 マスクされた列の値は資格情報であるため、******** と表示されます。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 を使用すると値がシェルの履歴やプロセスの一覧に残るため、--body は拒否されます。 どちらのコマンドも --output table を受け付けません。 ForceUpdate を指定すると、同じ名前の既存の証明書またはシークレットが置き換えられます。本文ファイルは ソース管理に含めず、アップロードが完了したら削除してください。 certificate.json には、Base64 でエンコードされた PFX とそのパスワードが含まれます。
シークレットを別のファイルに書き込まずに本文を作成するには、本文を --body-file - にパイプします。 この例では、jq は自身の引数ではなく api-key.txt から値を読み取るため、 値はプロセスの一覧に表示されません。

mps asset upload

asset upload は、ローカル ファイルをマルチプレイヤー サーバーのアセットとしてアップロードします。リクエスト本文ではなく オプションを受け取り、アセット名とアップロードの状態を JSON として書き込みます。
最終更新日 2026年11月19日