> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 电脑

> 获取或切换此 Windows 电脑使用的 XBOX 沙盒,类似于 XblPCSandbox.exe。

`pc` 命令可获取或切换此 Windows 电脑使用的 XBOX 沙盒。它们属于实验性命令,并且仅在 Windows 上运行。请参阅
[实验性命令](https://docs.xbox.com/zh-CN/tools/xbox-cli/cli-command-lifecycle.md)。

一台电脑一次使用一个沙盒,该沙盒适用于电脑上的每个用户和每个游戏,游戏会登录到该沙盒。默认沙盒为 `RETAIL`。若要在开发沙盒(例如 `ABCDEF.1`)中测试游戏,请先将电脑切换到该沙盒。若要查看你的 Partner Center 帐户拥有哪些沙盒,请使用
[`xbox sandbox list`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/sandbox)。

## 命令

每个命令都会运行 `XblPCSandbox.exe`(即 XBOX 服务 PC Sandbox Switcher),其工作方式与
[其文档](https://learn.microsoft.com/gaming/gdk/docs/tools/tools-services/live-pc-sandbox-switcher)
所述相同。

| 命令 | 等同于 | 说明 |
| - | - | - |
| `pc sandbox get` | `XblPCSandbox /get` | 获取此电脑使用的沙盒。 |
| `pc sandbox set <sandbox-id>` | `XblPCSandbox /set <sandbox-id>` 或 `/retail` | 将此电脑切换到某个沙盒,或切换回 `RETAIL`。 |
| `pc sandbox launch-apps` | `XblPCSandbox /launchApps` | 在此电脑的沙盒中关闭并重新打开 Microsoft Store 和 XBOX 应用。 |

对于该工具的 `/feedback` 命令,请直接运行 `XblPCSandbox /feedback`。

## 切换沙盒

```bash theme={null}
xbox pc sandbox set ABCDEF.1 --confirm
```

`pc sandbox set` 会更改电脑上每个用户的沙盒。它在切换之前会进行询问,然后显示用户帐户控制 (UAC) 提示以请求管理员权限。它会重新启动电脑上的 XBOX 服务,并在 Microsoft Store 和 XBOX 应用已打开的情况下重新打开它们。然后,它会检查电脑是否使用了新沙盒。

即使电脑已经在使用该沙盒,`set` 也会执行切换。再次运行它会重新启动服务,这可以解决登录仍使用旧沙盒的问题。如果这样做没有帮助,请重启电脑,并参阅
[沙盒疑难解答](https://aka.ms/XboxLiveSandboxHelp)。

在从 Microsoft Store 更新 XBOX 应用或 Gaming Services 之前,请切换到 `RETAIL`。

## 安装工具

`XblPCSandbox.exe` 随 XBOX Game Development Kit (GDK) 一起提供,也包含在
[XBOX 服务开发工具版本](https://github.com/microsoft/xbox-live-developer-tools/releases)
页面上的 `XboxLiveTools.zip` 中。必须安装 Gaming Services(在电脑上运行 XBOX 功能的 Windows 服务)。
CLI 按以下顺序查找该工具:

1. `XblPCSandbox:Path` 设置,例如 `XBOX_XBLPCSANDBOX__PATH` 环境变量。
2. 包含 CLI 的文件夹。
3. `PATH` 上的每个文件夹。

## 选项

| 选项 | 命令 | 说明 |
| - | - | - |
| `--confirm`, `--yes`, `-y` | `set` | 切换时不显示确认提示。在交互式终端之外是必需的。 |
| `--no-apps` | `set` | 不重新打开 Microsoft Store 和 XBOX 应用,类似于该工具的 `/noApps`。稍后运行 `launch-apps` 可重新打开它们。 |
| `--output <format>` | 全部 | `json`(默认)、`json-compact` 或 `table`。 |

## 输出

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

## 错误

| 原因 | 结果 |
| - | - |
| 拒绝了 UAC 提示 | 沙盒未更改。 |
| Gaming Services 缺失或无法正常工作 | 该工具的输出会指明原因,错误中会包含指向 Gaming Services 修复工具的链接。 |
| 切换未生效 | 该工具报告成功,但电脑使用的是其他沙盒。请再次运行切换;如果仍然失败,请重启电脑。 |
| 未找到该工具 | 错误会说明 CLI 查找的位置以及如何安装该工具。 |
| 你按下了 Ctrl+C | CLI 会停止该工具。如果你已接受 UAC 提示,切换可能仍会完成;请使用 `xbox pc sandbox get` 进行检查。 |

该工具的错误包含指向[沙盒疑难解答](https://aka.ms/XboxLiveSandboxHelp)的链接,并建议使用 `XblPCSandbox /feedback` 报告问题。

## 示例

获取此电脑使用的沙盒:

```bash theme={null}
xbox pc sandbox get
```

切换到开发沙盒,但不重新打开 Microsoft Store 和 XBOX 应用,然后再重新打开它们:

```bash theme={null}
xbox pc sandbox set ABCDEF.1 --confirm --no-apps
xbox pc sandbox launch-apps
```

切换回 `RETAIL`:

```bash theme={null}
xbox pc sandbox set RETAIL --confirm
```


## Related topics

- [使用 XBOX 多人游戏分析工具检查和修改网络流量](https://docs.xbox.com/zh-CN/tools/tools-services/live-xbox-multiplayer-analysis-tool.md)
- [xbox.com/play 上的 Web 内容测试应用 (CTA)](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-web-content-test-application-xbox-com-play.md)
- [沙盒](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/sandbox.md)
- [Direct3D 12 编程指南](https://docs.xbox.com/zh-CN/build/gdk-and-engines/guides/directx-12-programming-guide.md)
- [使用 TAK CLI 部署触控布局](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-deploying-touch-layout.md)
