你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure CLI 入门

项目
03/08/2024

欢迎使用 Azure 命令行界面 (CLI)！本文介绍 CLI 并帮助你完成常见任务。

在 Azure Cloud Shell 中安装或运行

了解如何使用 Azure CLI 的最简单方法是通过浏览器在 Azure Cloud Shell 中运行 Bash 环境。若要了解 Cloud Shell，请参阅 Azure Cloud Shell 中的 Bash 快速入门。

准备好安装 Azure CLI 后，请参阅 Windows、Linux、macOS 和 Docker 容器的安装说明。如果使用 Azure 经典部署模型，请安装 Azure 经典 CLI。

通过运行 az --version来检查版本。 Azure Cloud Shell 始终预安装了最新版本的 Azure CLI。

az version

登录到 Azure CLI

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

运行 az login 命令。
```
az login
```
如果 Azure CLI 可以打开默认浏览器，则会启动授权代码流，并打开默认浏览器来加载 Azure 登录页面。

否则，它会启动设备代码流，并指示打开浏览器页面，于 https://aka.ms/devicelogin。然后，输入终端中显示的代码。

如果没有可用的 Web 浏览器或 Web 浏览器无法打开，可通过 az login --use-device-code 强制使用设备代码流。
在浏览器中使用帐户凭据登录。

登录后，会收到与 Azure 帐户关联的订阅列表。在使用 isDefault: true 的情况下显示的订阅信息是登录后当前已激活的订阅。若要选择另一个订阅，请使用具有所需帐户的订阅 ID 的 az account set 命令。有关订阅选择的详细信息，请参阅 “管理 Azure 订阅”。

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

查找命令

Azure CLI 命令组织为命令组。每个组表示 Azure 服务的一个区域。有两个选项可用于查找命令组：

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

使用 --help 参数获取引用组中子组的完整列表。此示例返回虚拟机的所有子组：

az vm --help

下面是为简洁起见省略的行的示例输出：

Subgroups:
  application            : Manage applications for VM.
  availability-set       : Group resources into availability sets.
  boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
  ...

下面是另一个示例，它查找用于将虚拟机分组到可用性集（一个子组） az vm的 Azure CLI 命令：

az vm availability-set --help

还用于 --help 获取引用命令的参数列表和命令示例。

az vm create --help

下面是为简洁起见省略的行的示例输出：

Arguments
    --name  [Required] : Name of the virtual machine.
    ...
Authentication Arguments
    --admin-password   : Password for the VM if authentication type is 'Password'.
    --admin-username   : Username for the VM...
    ...
Managed Service Identity Arguments
    ...
Examples
    Create a VM from a custom managed image.
      az vm create -g MyResourceGroup -n MyVm --image MyImage
    ...

使用按字母顺序列出所有命令组的 A 到 Z 引用索引。

查找已发布的示例和文章

如果想要通过查看经过测试的已发布示例来了解 Azure CLI 语法，则文章内容有两个索引：

示例索引 A 到 Z。示例索引提供按主题区域、参考组和 GitHub 存储库排序的 Azure CLI 示例列表。

项目索引 A 到 Z。使用键盘 find 快捷键（例如 Ctrl + F）快速删除你感兴趣的参考命令组。例如，项目索引如下所示 az vm：

参考子组	介绍引用用法的 Azure CLI 文章
az vm	Azure CLI 命令的输出格式
	如何在 Azure CLI 命令中使用变量
	通过查询获取 VM 信息
	{此处列出的更多文章。}
az vm aem	适用于 SAP 解决方案的 Azure VM 扩展的新版本
	适用于 SAP 解决方案的 Azure VM 扩展的标准版本
az vm application	{...}

使用选项卡完成

CLI 为 Bash 环境中的命令提供完整选项卡完成。若要在 PowerShell 环境中启用选项卡完成，请参阅 PowerShell 中的“启用选项卡完成”。

注意全局可用的参数

有一些参数可用于大多数命令。

--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 标志生成的输出。
--subscription 是订阅的名称或 ID。有关设置默认订阅的详细信息，请参阅使用 Azure CLI 管理 Azure 订阅。
--only-show-errors 取消命令输出中的警告，并仅显示错误。

使用交互式模式

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

az interactive

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

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

通过快速入门和教程了解 Azure CLI 基础知识

若要了解如何使用 Azure CLI，请尝试我们的载入教程，在处理Azure 存储时教授以下技能：

注意

在脚本和 Microsoft 文档站点上，Azure CLI 示例是为 Bash shell 编写的。大多数单行示例将在任何平台上运行。需要修改包含行延续（\）、变量赋值 或引号 在内的较长示例才能在其他 shell（包括 PowerShell）中工作。有关环境之间的语法差异的详细信息，请参阅了解 Bash、PowerShell 和 Cmd 之间的语法差异。

提供反馈

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

az feedback