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

什么是 Azure CLI？

项目
03/11/2024

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.66.0。有关最新版本的信息，请参阅发行说明。若要查找已安装的版本并查看是否需要更新，请运行 az 版本。

身份验证

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 语法比较

选择正确的命令行工具通过重点对比 Azure CLI 和 Azure PowerShell 来说明了 tools 和 environments 之间的不同之处。它还提供多个并行的命令比较。这里是两个示例：

命令	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

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

az config set core.output=jsonc

数据收集

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

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

通过