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 會依下列順序尋找此工具:
XblPCSandbox:Path設定,例如XBOX_XBLPCSANDBOX__PATH環境變數。- 包含 CLI 的資料夾。
PATH上的每個資料夾。
選項
輸出
get 和 launch-apps 會傳回 {"sandbox": "ABCDEF.1"},而 set 會傳回 {"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}。使用 --output table 時,欄為 SANDBOX,set 則另有 PREVIOUS SANDBOX。工具本身的輸出會傳送到 stderr。
錯誤
工具的錯誤會連結至沙箱疑難排解,並建議使用
XblPCSandbox /feedback 回報問題。
範例
取得此 PC 使用的沙箱:RETAIL:
