login

重要

这是 Azure Sphere（旧版）文档。 Azure Sphere（旧版）将于 2027 年 9 月 27 日停用，用户此时必须迁移到 Azure Sphere（集成）。 使用位于 TOC 上方的版本选择器查看 Azure Sphere（集成）文档。

登录到 Azure Sphere 安全服务。 默认情况下，所有 azsphere 命令都适用于当前用户的登录标识和租户。 login 命令可以使用不同的标识。

使用 azsphere 时，Azure Sphere 安全服务使用 Microsoft Azure Active Directory（AAD）来验证身份。 AAD 使用单一登录 (SSO)，通常默认为电脑上的现有标识。 如果此标识无法与 Azure Sphere 租户一起使用，则 azsphere 命令可能会失败。 有关详细信息，请参阅 连接Microsoft帐户。

使用 登录 名显式登录到 Azure Sphere 安全服务。 成功后，此标识将用于后续的 azsphere 命令。 在大多数情况下，只需登录一次。

可选参数

参数	类型	描述
--use-device-code	字符串	基于设备代码提供备用登录机制。 如果 CLI 无法启动浏览器，将用于身份验证。 要详细了解这种形式的身份验证，请参阅设备代码流。

全局参数

以下全局参数可用于 Azure Sphere CLI：

参数	说明
--debug	增加日志记录详细程度以显示所有调试日志。 如果发现了 bug，在提交 bug 报告时，请提供启用 --debug 标志生成的输出。
-h、--help	打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。
--only-show-errors	仅显示错误，禁止显示警告。
-o、--output	更改输出格式。 可用的输出格式为 json、jsonc（彩色 JSON）、tsv（制表分隔值）、表（人可读 ASCII 表）和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。
--query	使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。
--verbose	打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 使用 --debug 获取完整的调试日志。

注意

如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，了解有关可用选项的详细信息。

示例

azsphere login
 ---------------------
 Name
 =====================
 bob@contoso.com
 ---------------------

作为响应，应会看到一个对话框，提示你登录。 如果列表包含用于 Azure Sphere 的标识，请选择该标识。 如果没有，请输入适当的凭据。