跳轉到主要內容
pc 命令可取得或切換此 Windows PC 使用的 XBOX 沙箱。這些命令為實驗性功能,而且只能在 Windows 上執行。請參閱實驗性命令。 PC 一次只使用一個沙箱,套用於其上的每個使用者和每個遊戲,而遊戲會登入該沙箱。預設值為 RETAIL。若要在開發沙箱 (例如 ABCDEF.1) 中測試遊戲,請先將 PC 切換到該沙箱。若要查看您的 Partner Center 帳戶擁有哪些沙箱,請使用 xbox sandbox list。

命令

每個命令都會執行 XblPCSandbox.exe (XBOX services PC 沙箱切換器),其運作方式如其文件所述。 若要使用工具的 /feedback 命令,請直接執行 XblPCSandbox /feedback。

切換沙箱

pc sandbox set 會變更 PC 上每個使用者的沙箱。它在切換之前會先詢問,然後顯示要求系統管理員權限的使用者帳戶控制 (UAC) 提示。它會重新啟動 PC 上的 XBOX services,並在 Microsoft Store 和 XBOX 應用程式原本已開啟時重新開啟它們。接著,它會檢查 PC 是否使用新的沙箱。 即使 PC 已經在使用該沙箱,set 仍會進行切換。再次執行它會重新啟動服務,這可以修正仍使用舊沙箱的登入問題。如果這樣沒有幫助,請重新啟動 PC,並參閱沙箱疑難排解。 從 Microsoft Store 更新 XBOX 應用程式或 Gaming Services 之前,請先切換到 RETAIL。

安裝工具

XblPCSandbox.exe 隨附於 XBOX 遊戲開發套件 (GDK),也包含在 XBOX services 開發工具版本頁面上的 XboxLiveTools.zip 中。必須安裝 Gaming Services (在 PC 上執行 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 回報問題。

範例

取得此 PC 使用的沙箱:
切換到開發沙箱而不重新開啟 Microsoft Store 和 XBOX 應用程式,然後再重新開啟它們:
切換回 RETAIL:
最後修改於 2026年11月19日