> ## 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.

# PC 沙箱切換器 (XblPCSandbox.exe)

> 命令列 XblPCSandbox.exe 工具，可顯示、切換 XBOX 服務沙箱，並在沙箱中重新啟動 PC 應用程式，包括 Microsoft Store 與 XBOX App。

XblPCSandbox.exe 是一個管理 PC 上 XBOX 服務沙箱的命令列工具。您可以使用它來：

* 顯示目前的沙箱。
* 切換至開發沙箱或切換回 RETAIL。
* 以沙箱模式重新啟動系統應用程式 (Microsoft Store 與 XBOX App)。

## 開始使用

安裝 Microsoft Game Development Kit (GDK) 之後，開啟 GDK 命令提示字元並從中執行此工具。您可以執行下列動作來找到 GDK 命令提示字元：

1. 開啟 **開始** 功能表並搜尋 **Microsoft GDK Command Prompts**。
2. 從 **Microsoft GDK Command Prompts** 資料夾開啟捷徑 (選取已安裝的最新 GDK 版本)

此工具也隨附於 GDK 與 `XboxLiveTools.zip` 中；請參閱 [XBOX 服務的開發工具](https://docs.xbox.com/zh-TW/tools/tools-services/live-tools.md)。

> [!NOTE]
>
> 設定沙箱需要**提高權限** (以系統管理員身分執行)。如果您未以提高權限執行此工具，它會嘗試以提高權限的狀態重新執行。讀取沙箱 (`/get`) 與顯示說明 (`/?`) 不需要提高權限。

## 命令與選項參考

```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 App，但前提是它們已經開啟。在使用 `/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 App
5. 在切換之後顯示**新的沙箱**，讓您可以立即確認已套用。

如果系統應用程式在切換時**未開啟**，則**不會**自動啟動。

> [!NOTE]
>
> 此工具會自動修正沙箱名稱的大小寫。例如，輸入 `xdks.1` 會修正為 `XDKS.1`。
> 由於沙箱名稱為大寫，這可減少因大小寫區分所造成的錯誤。

### 設定沙箱但不重新啟動應用程式

```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 App) 重新啟動回一般模式。

> [!TIP]
>
> 您需要切換回 RETAIL，才能從 Microsoft Store 更新 XBOX App 或 Gaming Services。這些應用程式在開發沙箱中無法接收更新。

## 以沙箱模式啟動系統應用程式

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

以沙箱模式重新啟動 Microsoft Store 與 XBOX App，但前提是它們已經開啟。在使用 `/noApps` 選項切換沙箱之後很有用。

## 顯示說明

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

顯示所有可用命令與選項的說明資訊。說明文字也包含疑難排解建議，以及[登入與沙箱錯誤的疑難排解](https://docs.xbox.com/zh-TW/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)文件的連結。

## 提供意見反應

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

直接開啟意見反應中樞，讓您回報問題或提供有關沙箱切換體驗的意見反應。

## 另請參閱

* [沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
* [進階沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
* [登入與沙箱錯誤的疑難排解](https://docs.xbox.com/zh-TW/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
* [測試帳戶](https://docs.xbox.com/zh-TW/services/xbox-services/develop/test-accounts/live-test-accounts.md)
* [XBOX 服務的開發工具](https://docs.xbox.com/zh-TW/tools/tools-services/live-tools.md)


## Related topics

- [Xbox 服務沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [Steamworks 中沒有的 GDK 功能](https://docs.xbox.com/zh-TW/build/steam-porting-guide/gdk-features-not-in-steamworks.md)
- [XBOX 服務的開發工具](https://docs.xbox.com/zh-TW/tools/tools-services/live-tools.md)
- [XBOX 服務的工具](https://docs.xbox.com/zh-TW/tools/tools-services/live-tools-nav.md)
- [XBOX 與 PlayFab 的線上服務工具](https://docs.xbox.com/zh-TW/tools/tools-services/index.md)