你当前正在访问 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 服务的一部分，也可以是扩展。 扩展是可选加载项。 引用类型决定了发布计划、状态和安装方法，如下所述：

术语 核心 扩展
参考 是主要 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 引用都分为下面 3 种状态类别：GA（正式发布）、公共预览或试验 。 它是引用命令状态（不是类型），用于确定稳定性和支持级别。

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 核心 是
--newFutureParameter1 核心 是
--newFutureParameter2 核心 是
az network vhub list 全部 扩展 是
az network vhub create --address-prefix、--name、--resource-group、-vwan、--location、--sku 扩展 是
--newFutureParameter1 扩展 是
--newFutureParameter2 扩展 是
az network firewall create 全部 扩展 是

上表只是一个示例，并不代表示例的当前引用状态。

请参阅