通过

你当前正在访问 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 应用网关 创建 az 网络应用网关创建 --name、--resource-group、--capacity
Azure DevOps az pipelines 代理人 列表 列出 az 管道代理 --pool-id、--agent-name、--demands

引用子组可以具有多个级别，例如

参考组 子组 1 子组 2 子组 3 指令
网络 应用网关 私有链接 IP配置 添加

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

什么是引用类型？

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

术语 核心 扩展
参考 是主要 Azure CLI 服务的一部分 是必须安装的可选引用命令
安装 与 MSI 安装程序结合使用 通过 az extension add 单独使用
已发布 按计划 在新功能或更新可用时
地位 可以是正式版、预览版或已弃用的版本 也可以是 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 中心任务列表 是的

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

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

什么是引用状态？

无论引用类型如何，Azure CLI 引用都分为三种状态类别： 正式 版（正式发布）、 公共预览 版或 已弃用。 确定稳定性的是引用命令的状态（而非类型）。

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

注释

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

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

完整引用命令 参数 类型 乔治亚州 公共预览 已弃用
列出 DNS 区域的 az network dns zone list 命令 全部 核心 是的
az network dns zone create（创建 DNS 区域） --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 扩展 是的
--existingParameter7 扩展 是的
--newParameter8 扩展 是的
az 网络防火墙创建命令 全部 扩展 是的

上表只是一个示例，不代表当前参考状态az network。

另请参阅