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

什么是 Azure CLI?

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.59.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 来说明了 toolsenvironments 之间的不同之处。 它还提供多个并行的命令比较。 这里是两个示例:

命令 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 语法比较,请参阅 Learn 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 命令禁用数据收集。 还可以阅读我们的隐私声明,了解更多信息。

另请参阅