跳轉到主要內容
XBOX CLI 會以您的權限執行動作,且通常是針對生產遊戲和賣方。此頁面說明哪些命令只會讀取、哪些在變更內容之前會先詢問、少數會執行其名稱未表明之動作的命令,以及變更結果不明時該怎麼做。如需 AI 代理程式在變更之前必須詢問的事項,請參閱從代理程式使用 XBOX CLI。 命令會從旗標、XBOX_ 環境變數,或以 xbox context set 儲存的值取得其遊戲、賣方或沙箱。會變更內容的命令會在 stderr 上指出您未在其命令列上傳遞的每個值,因此請在進行生產變更之前檢查這些值。請參閱內容。

哪些是唯讀的

只有名稱以 Get、List 或 Search 開頭的 PlayFab 作業才是唯讀的,例如 /Admin/GetTitleData 或 /MultiplayerServer/ListBuildSummariesV2。其他所有作業都會變更內容。這對 xbox playfab api <api-path> 最為重要,因為您在其中輸入的是作業的路徑,而不是命令名稱。 命令的說明中有一個 SAFETY 區段,指出它是讀取還是變更內容。

哪些會先詢問

大多數會變更內容的命令都會在不詢問的情況下執行。下列命令在終端機中會先詢問,而在沒有終端機時,除非您傳遞 --confirm (--yes、-y),否則會拒絕執行:

命令名稱未表明的事項

  • 如果 playfab service-principal set 失敗,服務主體在 set 成功之前,可能在工作室中沒有任何存取權,這可能會使以其身分登入的管線停止。請傳遞 --expected-version,讓 set 失敗,而不是覆寫其他人的變更。
  • playfab privacy export 會將玩家在該發行者每個遊玩過的遊戲中的資料,以電子郵件傳送至遊戲的通知電子郵件地址。匯出及其電子郵件無法撤回。
  • 從其他沙箱執行 xbl config publish,會以來源的全域遊戲儲存體檔案取代目的地的檔案,並刪除只有目的地才有的檔案。刪除的檔案無法復原。
  • xbl config publish --sandbox-id HIDDEN 會發佈整個遊戲範圍的組態,每個沙箱 (包括 RETAIL) 都會使用此組態。

中斷的寫入會回報其結果不明

如果變更在 CLI 傳送後遭到中斷 (例如因為 Ctrl+C、逾時或連線中斷),或服務以 HTTP 5xx 錯誤回應,則變更可能已經套用。命令會指出其結果不明,如下列 PlayFab 錯誤所示:
在再次執行變更之前,請先讀取受影響的狀態。playfab 以外的命令會列印可用來檢查的唯讀命令。CLI 絕不會自行重試變更。 某些會等候作業的命令,在要求已被接受但等候結束時,會以 4 結束。請勿再次執行它們;如需如何繼續等候,請參閱該命令的頁面。
最後修改於 2026年11月19日