概述：Azure CLI 引用类型和状态
Azure CLI 具有不同的引用类型，它们在描述上有时可与引用状态互换。 本文说明了 Azure CLI 类型与状态之间的区别，还介绍了如何使用这两者。
Azure CLI 语法组件
Azure CLI 语法是引用、命令和参数的组合。 完整引用命令常被称为“命令”。
| Azure 服务 | 参考 | 引用子服务 | 命令 | 完整引用命令 | 参数示例 |
|---|---|---|---|---|---|
| Azure CLI | az configure | az configure | --defaults、--list-default、--scope | ||
| Azure 网络 | az network | application-gateway | create | az network application-gateway create | --name、--resource-group、--capacity |
| Azure DevOps Server | az pipelines | 代理 | list | az pipelines agent list | --pool-id、--agent-name、--demands |
引用类型
可通过引用类型了解引用命令是否是主要 Azure CLI 服务的一部分，以及它是否是可选的加载项。 有两种类型的 Azure CLI 引用命令：核心和扩展 core 。
| 核心 | 扩展 | |
|---|---|---|
| 参考 | 是主要 Azure CLI 服务的一部分 | 是必须安装的可选引用命令 |
| 安装 | 与 MSI 安装程序结合使用 | 通过 az extension add 单独使用 |
| 已发布 | 制定计划时 | 在新功能或更新可用时 |
| Status | 可以是 GA（正式发布）、预览版或试验版 | 也可以是通用版、预览版或试验版 |
所有 Azure CLI 引用都可在 Windows、macOS、Linux、Docker 中运行。
核心
已作为 CLI 的永久组成部分发布的 Azure CLI 引用被称为“核心引用”。 所有核心引用均使用 Azure CLI 进行安装，你无法只选择其中部分引用。有关核心引用命令的完整列表，请参阅 Azure CLI 的核心引用列表。
扩展
扩展不作为 CLI 的一部分传递，而是作为 CLI 命令运行。 某些扩展是 Azure CLI 的永久组成部分，但通常的情况是，扩展让你能够访问个人预览版和试验版的命令。 一个引用（例如 az iot hub）可以既是核心命令，又是扩展命令。 下面是 4 个示例：
| 完整引用命令 | 是核心 | 是扩展 |
|---|---|---|
| az iot hub list | 是 | |
| az iot hub query | 是 | |
| az iot hub certificate create | 是 | |
| az iot hub device identify create | 是 |
Important
使用之前，必须运行 az extension add 命令来安装扩展。
要详细了解扩展引用（包括安装和更新），可参阅将扩展与 Azure CLI 结合使用。 查看扩展 wiki 提示，实现最大限度的使用。 有关扩展引用命令的完整列表，请参阅 Azure CLI 的可用扩展。
引用状态
无论类型如何，Azure CLI 引用都分为下面 3 种状态类别：通用版、公共预览版或试验版 。 它是引用命令状态，不是类型，用于确定稳定性和支持级别。
| GA | 公共预览版 | 实验 | |
|---|---|---|---|
| 稳定性 | 永久性 | 可根据客户反馈更改。 需遵守 Microsoft Azure 预览版的条款。 | 可根据客户反馈更改。 常会迁移到公共预览版。 可删除。 |
| 支持级别 | 完全 | 部分 | 无 |
虽然一个引用的大多数命令和参数都有一个状态，但并不总是如此。 根据构建可提供更多命令的 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 | 全部 | 扩展 | 是 |
Note
指示是公共预览版还是试验版的警告是 Azure CLI 命令输出的一部分，应该是预期内容 。