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

> 取得或切換此 Windows PC 使用的 XBOX 沙箱，就像 XblPCSandbox.exe 一樣。

`pc` 命令可取得或切換此 Windows PC 使用的 XBOX 沙箱。這些命令為實驗性功能，而且只能在 Windows 上執行。請參閱[實驗性命令](https://docs.xbox.com/zh-TW/tools/xbox-cli/cli-command-lifecycle.md)。

PC 一次只使用一個沙箱，套用於其上的每個使用者和每個遊戲，而遊戲會登入該沙箱。預設值為 `RETAIL`。若要在開發沙箱 (例如 `ABCDEF.1`) 中測試遊戲，請先將 PC 切換到該沙箱。若要查看您的 Partner Center 帳戶擁有哪些沙箱，請使用 [`xbox sandbox list`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/sandbox)。

## 命令

每個命令都會執行 `XblPCSandbox.exe` (XBOX services PC 沙箱切換器)，其運作方式如[其文件](https://learn.microsoft.com/gaming/gdk/docs/tools/tools-services/live-pc-sandbox-switcher)所述。

| 命令 | 等同於 | 描述 |
| - | - | - |
| `pc sandbox get` | `XblPCSandbox /get` | 取得此 PC 使用的沙箱。 |
| `pc sandbox set <sandbox-id>` | `XblPCSandbox /set <sandbox-id>` 或 `/retail` | 將此 PC 切換到某個沙箱，或切換回 `RETAIL`。 |
| `pc sandbox launch-apps` | `XblPCSandbox /launchApps` | 在此 PC 的沙箱中關閉並重新開啟 Microsoft Store 和 XBOX 應用程式。 |

若要使用工具的 `/feedback` 命令，請直接執行 `XblPCSandbox /feedback`。

## 切換沙箱

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

`pc sandbox set` 會變更 PC 上每個使用者的沙箱。它在切換之前會先詢問，然後顯示要求系統管理員權限的使用者帳戶控制 (UAC) 提示。它會重新啟動 PC 上的 XBOX services，並在 Microsoft Store 和 XBOX 應用程式原本已開啟時重新開啟它們。接著，它會檢查 PC 是否使用新的沙箱。

即使 PC 已經在使用該沙箱，`set` 仍會進行切換。再次執行它會重新啟動服務，這可以修正仍使用舊沙箱的登入問題。如果這樣沒有幫助，請重新啟動 PC，並參閱[沙箱疑難排解](https://aka.ms/XboxLiveSandboxHelp)。

從 Microsoft Store 更新 XBOX 應用程式或 Gaming Services 之前，請先切換到 `RETAIL`。

## 安裝工具

`XblPCSandbox.exe` 隨附於 XBOX 遊戲開發套件 (GDK)，也包含在 [XBOX services 開發工具版本](https://github.com/microsoft/xbox-live-developer-tools/releases)頁面上的 `XboxLiveTools.zip` 中。必須安裝 Gaming Services (在 PC 上執行 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 修復工具。 |
| 切換未生效 | 工具回報成功，但 PC 使用的是另一個沙箱。請再次執行切換，如果仍然失敗，請重新啟動 PC。 |
| 找不到工具 | 錯誤會指出 CLI 搜尋的位置以及如何安裝工具。 |
| 您按下了 Ctrl+C | CLI 會停止工具。如果您已接受 UAC 提示，切換仍可能會完成；請使用 `xbox pc sandbox get` 進行檢查。 |

工具的錯誤會連結至[沙箱疑難排解](https://aka.ms/XboxLiveSandboxHelp)，並建議使用 `XblPCSandbox /feedback` 回報問題。

## 範例

取得此 PC 使用的沙箱：

```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

- [PC Bootstrapper](https://docs.xbox.com/zh-TW/build/gdk-and-engines/guides/pc-bootstrapper.md)
- [PC 遊戲註冊](https://docs.xbox.com/zh-TW/tools/tools-pc/title-registration-pc.md)
- [PC 封裝改進](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md)
- [Windows PC 上的 Fiddler](https://docs.xbox.com/zh-TW/build/console-features/networking/tools/fiddler-pc.md)
- [XBOX PC 遠端工具](https://docs.xbox.com/zh-TW/tools/tools-pc/xbox-pc-remote-tools/index.md)
