跳转到主要内容
pc 命令可获取或切换此 Windows 电脑使用的 XBOX 沙盒。它们属于实验性命令,并且仅在 Windows 上运行。请参阅 实验性命令。 一台电脑一次使用一个沙盒,该沙盒适用于电脑上的每个用户和每个游戏,游戏会登录到该沙盒。默认沙盒为 RETAIL。若要在开发沙盒(例如 ABCDEF.1)中测试游戏,请先将电脑切换到该沙盒。若要查看你的 Partner Center 帐户拥有哪些沙盒,请使用 xbox sandbox list。

命令

每个命令都会运行 XblPCSandbox.exe(即 XBOX 服务 PC Sandbox Switcher),其工作方式与 其文档 所述相同。 对于该工具的 /feedback 命令,请直接运行 XblPCSandbox /feedback。

切换沙盒

pc sandbox set 会更改电脑上每个用户的沙盒。它在切换之前会进行询问,然后显示用户帐户控制 (UAC) 提示以请求管理员权限。它会重新启动电脑上的 XBOX 服务,并在 Microsoft Store 和 XBOX 应用已打开的情况下重新打开它们。然后,它会检查电脑是否使用了新沙盒。 即使电脑已经在使用该沙盒,set 也会执行切换。再次运行它会重新启动服务,这可以解决登录仍使用旧沙盒的问题。如果这样做没有帮助,请重启电脑,并参阅 沙盒疑难解答。 在从 Microsoft Store 更新 XBOX 应用或 Gaming Services 之前,请切换到 RETAIL。

安装工具

XblPCSandbox.exe 随 XBOX Game Development Kit (GDK) 一起提供,也包含在 XBOX 服务开发工具版本 页面上的 XboxLiveTools.zip 中。必须安装 Gaming Services(在电脑上运行 XBOX 功能的 Windows 服务)。 CLI 按以下顺序查找该工具:
  1. XblPCSandbox:Path 设置,例如 XBOX_XBLPCSANDBOX__PATH 环境变量。
  2. 包含 CLI 的文件夹。
  3. PATH 上的每个文件夹。

选项

输出

get 和 launch-apps 返回 {"sandbox": "ABCDEF.1"},set 返回 {"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}。使用 --output table 时,列为 SANDBOX,对于 set 还有 PREVIOUS SANDBOX。该工具自身的输出会输出到 stderr。

错误

该工具的错误包含指向沙盒疑难解答的链接,并建议使用 XblPCSandbox /feedback 报告问题。

示例

获取此电脑使用的沙盒:
切换到开发沙盒,但不重新打开 Microsoft Store 和 XBOX 应用,然后再重新打开它们:
切换回 RETAIL:
最后修改于 2026年11月19日