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 を指定すると応答
本文が追加されます。スクリプトでは、文言ではなく終了コードで分岐してください。
