Azure CLI 入门

项目
2025-05-22

Azure CLI 是一种跨平台工具，可简化从命令行管理 Azure 资源。它针对自动化和易用性进行了优化，它支持使用与 Azure 资源管理器模型无缝集成的简单命令进行交互式会话和脚本编写。可以在浏览器中将它与 Azure Cloud Shell 配合使用，或在本地安装它，以便从首选终端使用。

在 Azure Cloud Shell 中安装或运行

尝试 Azure CLI 的最简单方法是通过 Azure Cloud Shell（基于浏览器的 shell）进行安装，无需安装。 Cloud Shell 支持 Bash 和 PowerShell，并预安装了最新版本的 Azure CLI。

若要在本地安装 Azure CLI，请参阅如何安装 Azure CLI。

若要检查版本，请运行：

az version

若要开始将 Azure CLI 与本地安装配合使用，请登录：

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

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

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

重要

从 2025 年开始，Microsoft将为 Azure CLI 和其他命令行工具强制实施强制 MFA。 MFA 只会影响Microsoft Entra ID 用户标识。它不会影响工作负荷标识，例如服务主体和托管标识。

如果您使用 az login 通过 Entra ID 和密码对脚本或自动化过程进行身份验证，请现在计划迁移到工作负载身份标识。有关详细信息，请参阅自动化方案中多重身份验证对 Azure CLI 的影响。

登录后，将显示订阅列表。标记为isDefault: true的那个当前处于活动状态。若要更改为其他订阅，请运行：

az account set --subscription "<subscription-id>"

有关订阅选择的详细信息，请参阅 “管理 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.
  ...

帮助输出包括子组、参数、身份验证选项和示例。

下面是另一个示例，查找用于将虚拟机分组到可用性集（子组）的 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
    ...

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

浏览示例和文章

有关用法示例，请参阅：

按主题、参考组或 GitHub 存储库划分的 Azure CLI 示例示例索引。

查找深入指南的文章索引。使用键盘 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	{...}

使用选项卡完成

Azure CLI 支持 Bash 中的选项卡完成。若要在 PowerShell 中启用它，请参阅在 PowerShell 中启用自动补全功能。

了解全局参数

大多数命令可用的常见参数包括：

论点	DESCRIPTION
`--help`	查看命令帮助
`--output`	更改输出格式：`json`、、`jsonc`、`tsv`、 `tableyaml`
`--query`	使用 JMESPath 筛选输出
`--verbose`	打印更多执行详细信息
`--debug`	显示用于调试的低级别 REST 调用
`--subscription`	指定订阅名称或 ID
`--only-show-errors`	禁止显示非关键输出

有关详细信息，请参阅输出格式和查询结果。

使用交互式模式

使用以下命令运行交互模式：

az interactive

交互式模式通过内联帮助和命令建议启动增强的 Azure CLI 体验。有关详细信息，请参阅交互模式。

可选的 VS Code 扩展提供类似的功能，包括自动完成和悬停提示。

通过教程和快速入门，学习相关内容

使用载入教程掌握 Azure CLI 基础知识。你将学会如何：

注释

Microsoft Learn 上的 Azure CLI 示例是为 Bash 编写的。单行程序通常跨 shell 工作，但多行脚本可能需要调整。有关详细信息，请参阅了解 Bash、PowerShell 和 Cmd 之间的语法差异

提供反馈

欢迎你提供宝贵意见。在 GitHub 上提交问题或运行：

az feedback

通过