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 会添加响应正文。脚本应根据退出代码而不是措辞进行分支。
