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

什么是 Azure CLI？

项目
03/09/2025

Azure 命令行接口 (CLI) 是一个跨平台的命令行工具，可连接到 Azure 并对 Azure 资源执行管理命令。它允许使用交互式命令行提示符或脚本通过终端执行命令。

若要以交互方式使用，请先启动 shell，例如在 Windows 上启动 cmd.exe 或在 Linux 或 macOS 上启动 Bash，然后在 shell 提示符处发出命令。若要自动执行重复性任务，请使用所选 shell 的脚本语法将 CLI 命令配置到 shell 脚本中，然后执行该脚本。

您可以在 Linux、macOS 或 Windows 计算机上本地安装 Azure CLI。可以通过浏览器中的 Azure Cloud Shell 使用它，也可以在 Docker 容器内运行。

当前版本

Azure CLI 的当前版本 2.70.0。有关最新版本的信息，请参阅发行说明。若要查找已安装的版本并查看是否需要更新，请运行 az version。

身份验证

Azure CLI 支持多种身份验证方法。有关使用 Azure CLI 登录 Azure 的详细信息，请参阅使用 Azure CLI 登录。

命令参考设计

Azure CLI 语法遵循一种简单的 reference name - command - parameter - parameter value 模式。例如，在订阅之间进行切换通常是一项常见任务。语法如下。

az account set --subscription "my subscription name"

Azure CLI 的另一种常见用途是管理角色分配。

az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor

有关管理订阅的详细信息，请参阅使用 Azure CLI 管理订阅。有关管理服务主体和角色分配的详细教程，请参阅使用 Azure CLI 创建 Azure 服务主体。

PowerShell 语法比较

选择合适的命令行工具，其中说明了tools和environments之间的差异，并特别强调了 Azure CLI 和 Azure PowerShell。它还提供多个并列命令比较。这里是两个示例：

命令	Azure CLI	Azure PowerShell
创建资源组	az group create --name <ResourceGroupName> --location eastus	New-AzResourceGroup -Name <ResourceGroupName> -Location eastus
创建 Azure 存储帐户	az storage account create --name StorageAccountName --resource-group ResourceGroupName --location eastus --sku Standard_LRS --kind StorageV2	New-AzStorageAccount -Name <StorageAccountName> -ResourceGroupName <ResourceGroupName> -Location eastus -SkuName Standard_LRS -Kind StorageV2

有关 Bash 和 PowerShell 环境之间的 Azure CLI 语法比较，请参阅了解 Bash、PowerShell 和 Cmd 中的 Azure CLI 语法差异。

输出格式

Azure CLI 使用 JSON 作为默认输出格式，但也提供其他格式，具体请参阅 Azure CLI 命令的输出格式。使用 --output 参数来格式化 Azure CLI 命令结果。下面是一个示例：

az account list --output table

通过设置 output 配置属性 (如 Azure CLI 配置中所述) 来设置默认输出。

az config set core.output=jsonc

数据收集

Azure CLI 会默认收集遥测数据。 Microsoft 聚合收集的数据以识别使用模式、识别常见问题并改善 Azure CLI 的体验。 Microsoft Azure CLI 不会收集任何私有或个人数据。例如，使用情况数据可帮助确定问题（如命令成功率较低），并帮助确定工作优先级。

虽然此数据提供的见解非常有用，但我们也了解并非人人都愿意发送使用情况数据。您可以使用 az config set core.collect_telemetry=false 命令禁用数据收集。还可以阅读我们的隐私声明，了解更多信息。

另请参阅

入职速查表
开始使用 Azure CLI
Azure CLI 命令的完整参考列表

通过