メインコンテンツへスキップ
XBOX サンドボックスは、パートナー センター アカウント内にある、Microsoft Store の製品と XBOX サービス用の 分離された環境です。RETAIL などのグローバル サンドボックスは Microsoft によって管理され、 ABCDEF.1 などの開発用サンドボックスはアカウントに属します。ゲーム公開ガイドの サンドボックスを参照してください。 Windows PC が使用するサンドボックスを切り替えるには、PC を参照してください。 各コマンドは、--seller-id または保存されている販売者で指定された 1 つの販売者を対象に動作します。 コンテキストを参照してください。それがパートナー センターで最後に選択した販売者でない場合は、 こちらの既知の問題を参照してください。

コマンド

引数とオプション

list から取得した sandboxId を、xbl コマンドの --sandbox-id オプションなどの他のコマンドに渡します。

サンドボックス ID

サンドボックス ID は、英字と数字に、ピリオドで区切られた省略可能なサフィックスを付けたもので、最大 64 文字です。CLI はこれを大文字に変換します。
  • get は、RETAIL や CERT.DEBUG などのグローバル サンドボックスを含め、任意のサンドボックス ID を受け付けます。
  • create には、4 ~ 60 文字の英字または数字、ピリオド、および先頭が 0 でない 0 ~ 999 の 数字が必要です (ABCDEF.1 など)。サフィックス .58 は Isolated サンドボックス用に予約されており、 UNDEFINED とグローバル サンドボックスの名前は使用できません。

出力

sandbox get はサンドボックスを 1 つ書き込みます。
sandbox list は、同じオブジェクトの sandboxes 配列を書き込みます。
list --output table には SANDBOX、TYPE、GLOBAL の列があり、get --output table には SANDBOX ID、TYPE、SELLER ID の列があります。create は --output table を拒否します。

サンドボックスの作成

sandbox create はサンドボックスを作成する前に確認を求めます。ターミナルがない場合は --confirm が必要です。 CLI ではサンドボックスを削除できません。複数の販売者に所属している場合は、最初に 既知の問題を確認してください。 サンドボックスが別の販売者に作成される可能性があります。 このコマンドは要求を 1 回送信し、作成ジョブを最大 2 分間待機します。ジョブが 成功すると、新しいサンドボックスを sandbox get と同じ形式で書き込みます。ジョブ ID、 相関 ID、および次に確認する内容は stderr に出力されます。終了コードが 3 または 4 の場合は、 sandbox get <sandbox-id> で確認し、サンドボックスを再度作成しないでください。

エラー

失敗した場合は、--output の値にかかわらず、相関 ID、HTTP ステータスに応じたガイダンス、 およびサービスのエラーの詳細 (ある場合) がテキストとして stderr に書き込まれます。--verbose を指定すると応答 本文が追加されます。スクリプトでは、文言ではなく終了コードで分岐してください。

例

サンドボックスを一覧表示し、そのうちの 2 つを取得します。
確認プロンプトなしでサンドボックスを作成します。
最終更新日 2026年11月19日