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

概述:Azure CLI 术语和支持级别

本文解释了 Azure CLI 术语。 包括语法组件、引用类型和状态。

Azure CLI 语法组件

Azure CLI 语法是组、引用、命令和参数的组合。 完整引用命令常被称为“命令”。

Azure 服务 引用组 引用子组 命令 完整引用命令 参数示例
Azure CLI az config az config --local, --output -o
Azure 网络 az network application-gateway create az network application-gateway create --name、--resource-group、--capacity
Azure DevOps az pipelines 代理 list az pipelines agent list --pool-id、--agent-name、--demands

引用子组可以具有多个级别,例如 az network application-gateway private-link ip-config add

引用组 子组 1 子组 2 子组 3 命令
network application-gateway private-link ip-config add

有关引用命令的完整列表,请参阅引用列表 A - Z

什么是引用类型?

Azure CLI 命令可以是核心 Azure CLI 服务的一部分,也可以是扩展。 扩展是可选加载项。 引用类型决定了发布计划、状态和安装方法,如下所述:

Term 核心 扩展
参考 是主要 Azure CLI 服务的一部分 是必须安装的可选引用命令
安装 MSI 安装程序结合使用 通过 az extension add 单独使用
已发布 制定计划时 在新功能或更新可用时
Status 可以是正式版(正式版)、预览版或已弃用 也可以是 GA、预览版或已弃用

要获取命令组列表,请运行 az。 有关扩展列表,请使用 az extension list-available --output table 命令。

# Get list of all command groups
az

# Get list of extensions
az extension list-available --output table

核心

已作为 CLI 的永久组成部分发布的 Azure CLI 引用被称为“核心引用”。 所有核心引用均使用 Azure CLI 进行安装,并且无法只选择其中部分引用。 如果通过 Azure Cloud Shell 运行 CLI,则核心引用始终为最新状态。

扩展

扩展不作为 CLI 的一部分传递,而是作为 CLI 命令运行。 一些扩展是 Azure CLI 的永久组成部分,但通常的情况是,使用扩展可以访问预览版和试验版命令。 一个引用组(例如 az iot hub)可以既是核心命令,又是扩展命令。 这里是两个示例:

完整引用命令 是核心 是扩展
az iot hub list
az iot hub job list

首次使用时,系统会提示你安装扩展。 还可以通过运行 az extension add 命令来安装扩展。

要详细了解扩展引用(包括安装和更新),可参阅将扩展与 Azure CLI 结合使用。 有关扩展引用命令的完整列表,请参阅 Azure CLI 的可用扩展

什么是引用状态?

无论引用类型如何,Azure CLI 引用都分为三种状态类别: 正式 版(正式发布)、 公共预览 版或 弃用。 它是确定稳定性的引用命令状态(非类型)。

GA 公共预览版 已放弃
稳定性 永久性 可根据客户反馈更改。 需遵守 Microsoft Azure 预览版的条款。 将被删除。

注意

指示 公共预览版已弃用 的警告是 Azure CLI 命令输出的一部分,应为预期。

虽然单个引用的大多数命令和参数具有一个状态,但并不总是如此。 为了提供更多命令而构建的 GA 引用可以同时包含 GA 和预览参考命令。 随着添加新参数来增加功能,一个命令也可具有属于不同状态类别的参数。 下面是具有不同状态的示例引用:

完整引用命令 参数 类型 GA 公共预览版 已放弃
az network dns zone list 全部 核心
az network dns zone create --name、--resource-group、--if-none-match、--parent-name 核心
--existingParameter5 核心
--newParameter6 核心
az network vhub list 全部 扩展
az network vhub create --address-prefix、--name、--resource-group、-vwan、--location、--sku 扩展
--exsitingParameter7 扩展
--newParameter8 扩展
az network firewall create 全部 扩展

上表只是一个示例, 代表当前引用状态 az network

另请参阅