Azure CLI 入门

欢迎使用 Azure CLI！ 本文介绍 CLI 并帮助你完成常见任务。

安装

准备好安装 CLI 时，请参阅安装说明。

在第一次安装 CLI 后，请通过运行 az --version 检查它是否已安装，以及所安装的版本是否正确。

登录

对本地安装使用任何 CLI 命令之前，需要使用 az login 登录。

1. 运行 login 命令。

   az login
   

   如果 CLI 可以打开默认浏览器，它将这样做并加载 Azure 登录页。

   否则，请在 https://aka.ms/devicelogin 处打开浏览器页，然后输入终端中显示的授权代码。

   Note

   请先运行 az cloud set -n AzureChinaCloud 更改云环境，然后才能在 Azure 中国中使用 Azure CLI。若要切换回 Azure 公有云，请再次运行 az cloud set -n AzureCloud。

2. 在浏览器中使用帐户凭据登录。

登录后，你将看到与你的 Azure 帐户关联的订阅列表。 在使用 isDefault: true 的情况下显示的订阅信息是登录后当前已激活的订阅。 若要选择另一个订阅，请将 az account set 命令与要切换到的订阅 ID 配合使用。 有关订阅选择的详细信息，请参阅使用多个 Azure 订阅。

有多种方法可用来以非交互方式登录，使用 Azure CLI 登录中详细介绍了这些方法。

常用命令

此表列出了 CLI 中的一些常用命令及其参考文档的链接。

查找命令

CLI 中的命令以组命令的形式进行组织。 每个组表示一个 Azure 服务，命令针对该服务运行。

若要搜索命令，请使用 az find。 例如，若要搜索包含 secret 的命令名称，请使用以下命令：

az find secret

使用 --help 参数获取组的命令和子组的完整列表。 例如，若要查找用于处理网络安全组 (NSG) 的 CLI 命令，请运行：

az network nsg --help

CLI 为 bash shell 下的命令提供完整 tab 键补全。

全局可用参数

有一些参数可用于每条命令。

• --help 会输出有关命令及其参数的 CLI 参考信息并列出可用的子组和命令。
• --output 可更改输出格式。 可用的输出格式包括 json、jsonc（彩色 JSON）、tsv（制表符分隔值）、table（用户可读 ASCII 表）以及 yaml。 默认情况下，CLI 输出 json。 若要详细了解可用输出格式，请参阅 Azure CLI 的输出格式。
• --query 使用 JMESPath 查询语言筛选从 Azure 服务返回的输出。 若要详细了解查询，请参阅使用 Azure CLI 查询命令结果和 JMESPath 教程。
• --verbose 输出有关操作期间在 Azure 中创建的资源的信息和其他有用信息。
• --debug 输出有关 CLI 操作的更详细信息，用于调试目的。 如果发现了 bug，在提交 bug 报告时，请提供启用 --debug 标志生成的输出。

交互模式

CLI 提供一种交互模式，可自动显示帮助信息，并可更轻松地选择子命令。 使用 az interactive 命令即可进入交互模式。

az interactive

有关交互模式的详细信息，请参阅 Azure CLI 交互模式。

此外，还有提供交互体验的 Visual Studio Code 插件，包括自动完成和鼠标悬停显示的文档。

使用快速入门和教程了解 CLI 基础知识

若要开始使用 Azure CLI，请试用深入教程以设置虚拟机并利用 CLI 的功能查询 Azure 资源。

其他热门服务也有快速入门教程。

• 使用 Azure CLI 创建存储帐户
• 使用 CLI 向/从 Azure Blob 存储转移对象
• 使用 Azure CLI 创建单一 Azure SQL 数据库
• 使用 Azure CLI 创建 Azure Database for MySQL 服务器
• 使用 Azure CLI 创建用于 PostgreSQL 的 Azure 数据库
• 在 Azure 中创建 Python Web 应用

提供反馈

我们欢迎你提供有关 CLI 的反馈以帮助我们改进和解决 bug。 可以在 Github 上提出问题，或利用 CLI 的内置功能来通过 az feedback 命令留下常规反馈。

az feedback

另请参阅

• Azure CLI 可以管理的服务
• Azure CLI 的完整命令参考列表
• 有关如何使用 Azure CLI 的热门文章