playfab mps 命令系列為實驗性功能。其 CLI 介面可能會根據意見反應而變更或移除。
playfab mps 管理 PlayFab 多人遊戲伺服器 (MPS):組建及其別名和區域、伺服器、資產、憑證、秘密、容器映像、配額,以及虛擬機器 (VM)。它涵蓋的作業與 PlayFab 的 MpsPowershell 模組相同;與其 Set-PfTitle 對等的命令是 xbox context set playfab-title-id <id>。請參閱內容。
命令樹狀結構
每個命令都在xbox playfab mps 底下執行。
要求本文
大多數 MPS 命令都會傳送作業的 JSON 要求物件,就像playfab api 一樣:
--body 和 --body-file 無法合併使用。certificate upload 和 secret upload 只採用 --body-file,而 asset upload 兩者都不採用;請參閱其各自的章節。
破壞性命令
這些命令在終端機中會先詢問,在其他環境中則需要--confirm (--yes、-y):build delete、build alias delete、build region delete、server shutdown、asset delete、certificate delete、secret delete、container-image repository delete 和 remote-user delete。搭配 --body-file - 時,即使在終端機中,它們也需要 --confirm。其他會變更內容的 MPS 命令執行時不會詢問。請參閱安全性和破壞性作業。
分頁
這些清單命令每次呼叫會傳回一頁結果:build list、build alias listserver list、server list-archivedasset list、certificate list、secret listcontainer-image list、container-image list-tagsvirtual-machine list
SkipToken 會被設定。若要取得下一頁,請將含有該值的 "SkipToken" 加入要求本文、保留其他欄位,並重複執行,直到 SkipToken 傳回 null 為止。在要求本文中設定 "PageSize",即可變更每頁包含的結果數。
取得第一頁組建:
SkipToken 不是 null,請傳遞該權杖以取得下一頁:
SkipToken 欄,因此當還有更多結果時,表格之後會在 stderr 上顯示包含要傳送之權杖的通知。
表格輸出
這些表格中的命令接受--output table;其他 MPS 命令則不接受。請參閱表格輸出。
傳回單一記錄的命令會將其顯示為一列:
已遮蔽的欄會列印
********,因為其值是認證。JSON 輸出會傳回實際值。
mps build create
build create 需要 --type (用來選取它所呼叫的 PlayFab API),並且與其他 MPS 命令一樣採用要求本文:
mps certificate upload 和 mps secret upload
certificate upload 和 secret upload 只透過 --body-file <path> (或用於 stdin 的 --body-file -) 採用其要求本文,因為本文包含 PFX 密碼或秘密值。它們會拒絕 --body,因為這會讓該值留在 shell 歷程記錄和處理程序清單中。兩者都不接受 --output table。
ForceUpdate 會取代已使用該名稱的憑證或秘密。請勿將本文檔案納入原始檔控制,並在上傳後刪除它。
certificate.json 包含 Base64 編碼的 PFX 及其密碼:
--body-file -。此處,jq 會從 api-key.txt 讀取值,而不是從其自身的引數讀取,因此該值不會出現在處理程序清單中:
mps asset upload
asset upload 會將本機檔案上傳為多人遊戲伺服器資產。它採用選項而非要求本文,並以 JSON 寫入資產名稱和上傳狀態。
