跳转到主要内容
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日