跳轉到主要內容
xbox auth 管理其他命令所使用的 Microsoft Entra ID 帳戶。如需登入運作方式的相關資訊 (包括以服務主體身分登入),請參閱驗證。
沒有任何 auth 命令接受 --output table。 當 XBOX_AUTHENTICATION__MODE 選取服務主體模式時,auth login 和 auth logout 會以 1 結束,而 auth status 會描述服務主體。

auth login

使用 Microsoft Entra ID 登入,取代任何已登入的帳戶。
命令會開啟系統瀏覽器,並在成功時列印帳戶及其權杖的到期時間。之後的每個命令都會使用該帳戶。如果快取了多個帳戶 (例如由較早的 CLI 版本所快取),命令會失敗,直到您再次執行 auth login 為止。

auth logout

登出所有快取的帳戶。
命令會列印它所登出的帳戶,或指出沒有任何帳戶已登入。以 context set 儲存的值會保留,以相同帳戶重新登入即可還原這些值。

auth status

顯示已登入的帳戶及其權杖。命令可以透過 Entra ID 重新整理權杖,但不會使用它,因此無法確認其他命令是否會接受該權杖。若要查看已儲存的賣方和 PlayFab 遊戲,請執行 xbox context get。
除非您傳遞 --output,否則輸出為文字。若是指令碼,請要求 JSON 並檢查 signedIn:

服務主體模式

在服務主體模式中,auth status 會取得僅限應用程式的權杖並回報其宣告。它絕不會列印權杖。
服務主體或受控識別的 principalType 為 app。請參閱確認身分識別。
最後修改於 2026年11月19日