跳转到主要内容
XBOX 沙盒是 Partner Center 帐户中用于 Microsoft Store 产品和 XBOX 服务的隔离环境。全局沙盒(例如 RETAIL)由 Microsoft 管理; 开发沙盒(例如 ABCDEF.1)属于你的帐户。请参阅游戏发布指南中的 沙盒。若要切换 Windows 电脑使用的沙盒,请参阅电脑。 每个命令都作用于一个卖家,该卖家来自 --seller-id 或你已保存的卖家;请参阅 上下文。如果它不是你上次在 Partner Center 中选择的卖家,请参阅 此已知问题。

命令

参数和选项

请将 list 中的 sandboxId 传递给其他命令,例如 xbl 命令的 --sandbox-id 选项。

沙盒 ID

沙盒 ID 由字母和数字组成,可带有以句点分隔的可选后缀,最多 64 个字符。CLI 会将其转换为大写。
  • get 接受任何沙盒 ID,包括全局沙盒 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、关联 ID 以及接下来要检查的内容会输出到 stderr。当退出代码为 3 或 4 时,请使用 sandbox get <sandbox-id> 进行检查,不要再次创建沙盒。

错误

无论 --output 是什么,失败时都会向 stderr 写入文本:关联 ID、针对 HTTP 状态的指导,以及服务的错误详细信息(如果有)。--verbose 会添加响应正文。脚本应根据退出代码而不是措辞进行分支。

示例

列出沙盒,并获取其中两个:
创建沙盒,不显示确认提示:
最后修改于 2026年11月19日