你当前正在访问 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。
