メインコンテンツへスキップ
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 が成功するまで、 サービス プリンシパルがスタジオでアクセス権を持たない状態になる可能性があります。その場合、そのサービス プリンシパルとして サインインするパイプラインが停止することがあります。--expected-version を渡すと、他のユーザーの変更を上書きする代わりに set が失敗するようになります。
  • 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日