跳轉到主要內容
XBOX 沙箱是 Partner Center 帳戶中的隔離環境,供 Microsoft Store 產品和 XBOX services 使用。全域沙箱 (例如 RETAIL) 由 Microsoft 管理;開發沙箱 (例如 ABCDEF.1) 則屬於您的帳戶。請參閱遊戲發行指南中的沙箱。若要切換 Windows PC 使用的沙箱,請參閱 PC。 每個命令都會作用於一個賣方,該賣方來自 --seller-id 或您已儲存的賣方;請參閱內容。如果那不是您上次在 Partner Center 中選取的賣方,請參閱此已知問題。

命令

引數和選項

將來自 list 的 sandboxId 傳遞給其他命令,例如 xbl 命令的 --sandbox-id 選項。

沙箱 ID

沙箱 ID 由字母和數字組成,可選擇加上以句點分隔的尾碼,最多 64 個字元。CLI 會將其轉換為大寫。
  • get 接受任何沙箱 ID,包括全域沙箱,例如 RETAIL 和 CERT.DEBUG。
  • create 需要 4 到 60 個字母或數字、一個句點,以及一個從 0 到 999 且不含前置零的數字,例如 ABCDEF.1。尾碼 .58 保留給隔離沙箱,且不可使用 UNDEFINED 和全域沙箱名稱。

輸出

sandbox get 會寫入一個沙箱:
sandbox list 會寫入由相同物件組成的 sandboxes 陣列:
list --output table 包含 SANDBOX、TYPE 和 GLOBAL 欄,而 get --output table 包含 SANDBOX ID、TYPE 和 SELLER ID 欄。create 會拒絕 --output table。

建立沙箱

sandbox create 在建立沙箱之前會先詢問;沒有終端機時,需要 --confirm。CLI 無法刪除沙箱。如果您屬於多個賣方,請先查看此已知問題:沙箱可能會建立在另一個賣方中。 命令只會傳送一次要求,並最多等候建立作業兩分鐘。作業成功時,它會以與 sandbox get 相同的形式寫入新的沙箱。作業 ID、相互關聯識別碼以及接下來要檢查的項目會傳送到 stderr。當結束代碼為 3 或 4 時,請使用 sandbox get <sandbox-id> 進行檢查,不要再次建立沙箱。

錯誤

無論 --output 為何,失敗時都會將文字寫入 stderr:相互關聯識別碼、針對 HTTP 狀態的指引,以及服務的錯誤詳細資料 (如果有的話)。--verbose 會加入回應本文。指令碼應根據結束代碼而非文字內容來分支。

範例

列出沙箱,並取得其中兩個:
建立沙箱而不顯示確認提示:
最後修改於 2026年11月19日