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

# PC 沙盒切换器 (XblPCSandbox.exe)

> 命令行工具 XblPCSandbox.exe，用于显示、切换和重新启动 XBOX 服务沙盒中的 PC 应用，包括 Microsoft Store 和 XBOX App。

XblPCSandbox.exe 是一个命令行工具,用于管理 PC 上的 XBOX 服务沙盒。使用它可以:

* 显示当前沙盒。
* 切换到开发沙盒或切换回 RETAIL。
* 在沙盒模式下重新启动系统应用(Microsoft Store 和 XBOX 应用)。

## 入门

安装 Microsoft 游戏开发工具包 (GDK) 后,打开 GDK 命令提示符并从中运行该工具。可以通过执行以下操作找到 GDK 命令提示符:

1. 打开 **开始** 菜单并搜索 **Microsoft GDK Command Prompts**。
2. 从 **Microsoft GDK Command Prompts** 文件夹中打开快捷方式(选择已安装的最新 GDK 版本)

此工具也作为 GDK 和 `XboxLiveTools.zip` 的一部分提供;请参阅 [XBOX 服务开发工具](/tools/tools-services/live-tools)。

<Info>设置沙盒需要 **提升的特权**(以管理员身份运行)。如果你在没有提升的特权的情况下运行该工具,它将尝试以提升的状态重新运行。读取沙盒 (`/get`) 和显示帮助 (`/?`) 不需要提升。</Info>

## 命令和选项参考

```cmd theme={null}
Usage: XblPCSandbox [command] [options]
```

| 命令                  | 说明                                                                                                                                              |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `/get`              | 显示当前沙盒。如果未设置沙盒,则设备处于 RETAIL 中。                                                                                                                  |
| `/set <sandbox ID>` | 设置沙盒(例如,`XDKS.1`)。重新启动 XBOX Live Auth Manager 并在沙盒模式下重新启动任何 **打开的** 系统应用。如果要将沙盒切换回 RETAIL,请使用 'RETAIL' 作为沙盒名称,或使用下面描述的等效 /retail 选项。支持 /noApps。 |
| `/launchApps`       | 在沙盒模式下重新启动 Microsoft Store 和 XBOX 应用,但仅当它们已打开时。在 `/noApps` 切换后有用。                                                                               |
| `/retail`           | 等同于 `XblPCSandbox RETAIL`。一个便捷开关,将设备重置为默认消费者沙盒。                                                                                                 |
| `/feedback`         | 打开反馈中心,以便你可以报告有关沙盒切换体验的问题或提供反馈。                                                                                                                 |

| 选项         | 说明                                                                       |
| ---------- | ------------------------------------------------------------------------ |
| `/?`       | 显示所有可用命令和选项的帮助信息,包括故障排除提示以及故障排除文档的链接。                                    |
| `/help`    | 与 `/?` 相同。                                                               |
| `/noApps`  | 设置沙盒但 **不** 重新启动系统应用。之后使用 `xblPCSandbox /launchApps` 在准备就绪时在沙盒模式下重新启动它们。 |
| `/version` | 显示 xblPCSandbox 命令行工具的版本信息。                                              |

## 获取当前沙盒

```cmd theme={null}
XblPCSandbox /get
```

显示当前的 XBOX 服务沙盒。如果未设置沙盒,则设备处于 **RETAIL** 中。

## 设置沙盒

```cmd theme={null}
XblPCSandbox /set <sandbox ID>
```

设置设备的 XBOX 服务沙盒。例如:`XblPCSandbox /set XDKS.1`

设置沙盒时,该工具会:

1. 在切换之前显示 **当前沙盒**。
2. 在切换进行中显示 **进度旋转图标**。
3. 重新启动 **XBOX Live Auth Manager** 服务。
4. 在沙盒模式下重新启动以下 **系统应用**,但仅当它们已打开时:
   * Microsoft Store
   * XBOX 应用
5. 在切换后显示 **新沙盒**,以便你可以立即确认它已被应用。

如果在切换时系统应用 **未打开**,则不会自动启动。

<Note>该工具会自动更正沙盒名称的大小写。例如,键入 `xdks.1` 会被更正为 `XDKS.1`。
这减少了由大小写敏感性引起的错误,因为沙盒名称是大写的。</Note>

### 设置沙盒但不重新启动应用

```cmd theme={null}
XblPCSandbox /set <sandbox ID> /noApps
```

设置沙盒但不重新启动系统应用。之后可以使用以下命令重新启动它们:

```cmd theme={null}
XblPCSandbox /apps
```

## 切换回 RETAIL

```cmd theme={null}
XblPCSandbox /retail
```

或者

```cmd theme={null}
XblPCSandbox /set RETAIL
```

将设备重置为默认消费者沙盒。重新启动 XBOX Live Auth Manager,并将任何已打开的系统应用(Microsoft Store 和 XBOX 应用)重新启动回正常模式。

<Tip>你需要切换回 RETAIL 才能从 Microsoft Store 更新 XBOX 应用或 Gaming Services。这些应用在开发沙盒中时无法接收更新。</Tip>

## 在沙盒模式下启动系统应用

```cmd theme={null}
XblPCSandbox /apps
```

在沙盒模式下重新启动 Microsoft Store 和 XBOX 应用,但仅当它们已打开时。这在使用 `/noApps` 选项切换沙盒后有用。

## 显示帮助

```cmd theme={null}
XblPCSandbox /?
```

显示所有可用命令和选项的帮助信息。帮助文本还包括故障排除建议以及 [登录和沙盒错误的故障排除](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes) 文档的链接。

## 提供反馈

```cmd theme={null}
XblPCSandbox /feedback
```

直接打开反馈中心,以便你可以报告有关沙盒切换体验的问题或提供反馈。

## 另请参阅

* [沙盒概述](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox)
* [高级沙盒概述](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes)
* [登录和沙盒错误的故障排除](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)
* [测试帐户](/services/xbox-services/develop/test-accounts/live-test-accounts)
* [XBOX 服务开发工具](/tools/tools-services/live-tools)


## Related topics

- [XBOX 服务沙盒概述](/zh-CN/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [XBOX 服务开发工具](/zh-CN/tools/tools-services/live-tools.md)
- [XBOX 服务工具](/zh-CN/tools/tools-services/live-tools-nav.md)
- [PC 上的 XStore — DRM、许可证令牌和沙盒](/zh-CN/publishing/xstore-commerce/xstore-pc.md)
- [XBOX PC Remote 工具常见问题解答和故障排除指南](/zh-CN/tools/tools-pc/xbox-pc-remote-tools/faq.md)