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

Azure CLI 中即将出现的重大变更

除非另有说明,否则本部分中列出的中断性变更计划用于 Azure CLI 的下一个主要版本。 根据我们的 支持生命周期,Azure Core CLI 参考组中的重大更改每年发生两次。

ACR

acr config content-trust update

链接至 acr config 内容信任参考组

  • 在计划于 2026 年 5 月发布的下一个中断性变更版本(2.86.0)中删除启用了内容信任的配置。 该 --status enabled 参数将不再被接受,并将由于 Docker 内容信任弃用而导致错误。 若要了解有关破坏性变更的详细信息,请访问 https://aka.ms/acr/dctdeprecation

acr check-health

链接到 ACR 引用组

  • 下一个预定在 2026 年 5 月发布的重大变更版本(2.86.0)中,将删除 Notary 客户端版本验证。 由于 Docker 内容信任弃用,Notary 客户端版本检查将不再作为检查运行状况命令的一部分执行。 若要了解有关破坏性变更的详细信息,请访问 https://aka.ms/acr/dctdeprecation

acr config content-trust

链接至 acr config 内容信任参考组

acr helm

指向 acr helm 引用组的链接

  • 2020 年 11 月,Helm 2 结束了生命周期。 从 2025 年 3 月 30 日开始,Azure 容器注册表将不再支持 Helm 2。 因此,旧版“Helm 存储库”功能也将停用。 我们建议您立即过渡到 Helm 3。
  • 从 2025 年 1 月 21 日开始,CLI 命令 az acr helm push 已停用,以防止将新的 Helm Chart 推送到旧版 Helm 存储库。
  • 从 2025 年 3 月 30 日开始,CLI 命令组 az acr helm 已停用,结束了 Azure 容器注册表中的所有旧版 Helm 存储库功能。
  • 所有未存储为 OCI 项目的 Helm 图表已于 2025 年 3 月 30 日从 Azure 容器注册表中删除。
  • 在此处了解如何查找存储在 Helm 存储库中的所有 Helm 图表: az acr helm list。 如果列出了正在使用的 Helm 图表,则会将其存储在旧 Helm 存储库中,并面临删除风险。
  • 有关为 Kubernetes 管理和部署应用程序的更多信息,请参阅 https://aka.ms/acr/helm

compute_recommender

compute-recommender spot-placement-recommender

指向计算推荐器引用组的链接

  • “compute-recommender spot-placement-recommender”已弃用,将在计划于 2026 年 5 月的下一个重大变更版本(2.86.0)中删除。 请改用“az compute-recommender spot-placement-score”。

mysql

mysql flexible-server create

链接到 mysql 弹性服务器参考组

  • “--storage-redundancy”已弃用,将在计划于2026年5月推出的下一个重要版本更新(2.86.0)中删除。

mysql flexible-server restore

链接到 mysql 弹性服务器参考组

  • “--storage-redundancy”已弃用,将在计划于2026年5月推出的下一个重要版本更新(2.86.0)中删除。

mysql flexible-server geo-restore

链接到 mysql 弹性服务器参考组

  • “--storage-redundancy”已弃用,将在计划于2026年5月推出的下一个重要版本更新(2.86.0)中删除。

mysql flexible-server replica create

链接到 MySQL Flexible Server 副本引用组

  • “--storage-redundancy”已弃用,将在计划于2026年5月推出的下一个重要版本更新(2.86.0)中删除。

netappfiles

netappfiles volume update

链接到 netappfiles 卷引用组

  • “--remote-volume-resource-id” 已被弃用,将在计划于 2026 年 5 月发布的下一个包含重大变更的版本(2.86.0)中删除。

postgresql

postgres flexible-server create

链接到 postgres 灵活服务器参考组

  • “--high-availability”已弃用,将在计划于 2026 年 5 月的下一个重大变更版本(2.86.0)中删除。 请改用“--区域复原”。

postgres flexible-server update

链接到 postgres 灵活服务器参考组

  • “--high-availability”已弃用,将在计划于 2026 年 5 月的下一个重大变更版本(2.86.0)中删除。 请改用“--区域复原”。

postgres flexible-server replica create

链接到 postgres 灵活服务器副本引用组

  • “--replica-name” 已被弃用,并将在计划于 2026 年 5 月发布的下一个重大变更版本(2.86.0)中删除。 请改用“--name”。

postgres flexible-server firewall-rule

链接到 postgres 灵活服务器防火墙规则参考组

  • --name/-n 参数将重新用于指定防火墙规则名称。 将引入 --server-name/-s 参数,以在计划于 2026 年 5 月的下一个中断性变更版本(2.86.0)中指定服务器名称。
  • --rule-name/-r 参数已弃用,将在计划于 2026 年 5 月的下一个中断性变更版本(2.86.0)中删除。

postgres flexible-server migration

链接到 postgres 灵活服务器迁移参考组

  • --migration-name 参数已弃用,将在计划于 2026 年 5 月的下一个破坏性变更版本(2.86.0)中删除。
  • 将重新使用 --name/-n 参数来指定迁移名称。 将引入 --server-name/-s 参数,以在计划于 2026 年 5 月的下一个中断性变更版本(2.86.0)中指定服务器名称。

postgres flexible-server db

链接到 Postgres Flexible Server 数据库参考组

  • --database-name/-d 参数已弃用,将在计划于 2026 年 5 月的下一个中断性变更版本(2.86.0)中删除。
  • 将重新使用 --name/-n 参数来指定数据库名称。 将引入 --server-name/-s 参数,以在计划于 2026 年 5 月的下一个中断性变更版本(2.86.0)中指定服务器名称。

postgres flexible-server backup

Postgres灵活服务器备份参考组的链接

  • --backup-name/-b 参数已弃用,将在计划于 2026 年 5 月的下一个中断性变更版本(2.86.0)中删除。
  • 将重新使用 --name/-n 参数来指定备份名称。 将引入 --server-name/-s 参数,以在计划于 2026 年 5 月的下一个中断性变更版本(2.86.0)中指定服务器名称。

postgres flexible-server long-term-retention

链接到 postgres 灵活服务器长期保留参考组

  • --backup-name/-b 参数已弃用,将在计划于 2026 年 5 月的下一个中断性变更版本(2.86.0)中删除。
  • 将重新使用 --name/-n 参数来指定备份名称。 将引入 --server-name/-s 参数,以在计划于 2026 年 5 月的下一个中断性变更版本(2.86.0)中指定服务器名称。

postgres flexible-server index-tuning

链接到 PostgreSQL 灵活服务器索引调优参考组

  • 索引优化功能现已扩展其功能,以支持新命令涵盖的其他自动生成的建议。

资源

policy assignment identity assign

指向策略分配标识引用组的链接

  • 替换现有标识将在资源命令的未来版本中发生更改。 它首先需要删除现有标识。

policy assignment identity remove

指向策略分配标识引用组的链接

  • 在资源命令的未来版本中,删除用户分配的标识将发生更改。 它需要提供 --mi-user-assigned 开关。

policy assignment non-compliance-message create

链接到策略分配不合规消息引用组

  • 在资源命令的未来版本中,返回值将更改。 这将是单个创建的消息对象,而不是消息对象的完整数组。
  • 在资源命令的未来版本中,返回值将更改。 这将是单个创建的消息对象,而不是消息对象的完整数组。

policy assignment non-compliance-message delete

链接到策略分配不合规消息引用组

  • 在资源命令的未来版本中,返回值将更改。 它将为空,而不是剩余消息对象的完整数组。

policy set-definition delete

链接到策略集定义参考组

  • 资源命令的未来版本中的行为将发生变化。 绕过确认提示需要提供 -y 开关。

policy exemption create

指向策略豁免引用组的链接

  • 在资源命令的未来版本中,日期格式将略有变化。 新格式为 ISO-8601,例如 2025-08-05T00:45:13Z,而不是 2025-08-05T00:45:13+00:00。

policy exemption update

指向策略豁免引用组的链接

  • 在资源命令的未来版本中,日期格式将略有变化。 新格式为 ISO-8601,例如 2025-08-05T00:45:13Z,而不是 2025-08-05T00:45:13+00:00。

policy definition delete

指向策略定义引用组的链接

  • 资源命令的未来版本中的行为将发生变化。 绕过确认提示需要提供 -y 开关。

servicefabric

sf managed-application update

指向 sf 托管应用程序引用组的链接

  • 选项列表已更改,运行 help 命令以查看允许的选项

存储

storage account create

指向存储帐户引用组的链接

  • --min-tls-version 参数值TLS1_0和TLS1_1已于 2026/02/03 停用,将于 2026/03/03 中删除。

storage account update

指向存储帐户引用组的链接

  • --min-tls-version 参数值TLS1_0和TLS1_1已于 2026/02/03 停用,将于 2026/03/03 中删除。

vm

vm create

链接到虚拟机参考组

  • “--size”的默认值将在将来的版本中从“Standard_DS1_v2”更改为“Standard_D2s_v5”。

vmss create

链接到 vmss 引用组

  • 未来版本中,“--vm-sku”的默认值将从“Standard_DS1_v2”更改为“Standard_D2s_v5”。

sig image-version create

指向 sig 镜像版本引用组的链接

  • “--end-of-life-date”的默认值将在未来的某个版本中从“无”更改为“6 个月(自发布之日算起)”。
  • 未来版本中,“--block-deletion-before-end-of-life”的默认值将从“None”更改为“True”。

sig image-version update

指向 sig 镜像版本引用组的链接

  • “--end-of-life-date”的默认值将在未来的某个版本中从“无”更改为“6 个月(自发布之日算起)”。
  • 未来版本中,“--block-deletion-before-end-of-life”的默认值将从“None”更改为“True”。

azext_blueprint

blueprint

链接至蓝图参考组

azext_managednetworkfabric

networkfabric device upgrade

链接至网络结构设备参考组

  • 参数“--version”将在 9.0.x 中是必需的。

networkfabric l3domain create

链接到 networkfabric l3domain 参考组

  • “--route-prefix-limit”已弃用,将在 9.0.x 中删除。

networkfabric l3domain update

链接到 networkfabric l3domain 参考组

  • “--route-prefix-limit”已弃用,将在 9.0.x 中删除。

azext_neon

neon

链接到 neon 参考组

  • “az neon”已弃用,将在计划于 2026 年 5 月发布的下一个中断性变更版本(2.86.0)中删除。
  • 弃用通知:Neon Azure Native Integration 即将弃用,并将
  • 2026 年 1 月 31 日结束生活。 将你的项目转移到由 Neon 管理的组织
  • 今天。 迁移文档位于 https://neon.com/docs/import/migrate-from-azure-native

azext_netappfiles_preview

netappfiles volume update

链接到 netappfiles 卷引用组

  • “--remote-volume-resource-id” 已被弃用,将在计划于 2026 年 5 月发布的下一个包含重大变更的版本(2.86.0)中删除。

azext_redisenterprise

redisenterprise create

链接到 Redis Enterprise 参考组

  • 计划于 2026 年 5 月发布的下一个重大变更版本(2.86.0)中,参数“--public-network-access”将成为必需项。
  • 计划于 2026 年 5 月发布的下一个中断性变更版本(2.86.0)中,“--access-keys-auth”的默认值将从“Enabled”更改为“Disabled”。

azext_spring

spring

指向 Spring 引用组的链接

  • “spring”已被弃用,将于 2028 年 3 月删除。

azext_ssh

ssh vm

指向 ssh 引用组的链接

  • 2025 年 5 月 21 日,连接到版本 2.0.4 上的 <ARC 计算机的任何 ssh 命令将不再有效。 请升级到 az ssh 版本 >=2.0.4

ssh config

指向 ssh 引用组的链接

  • 2025 年 5 月 21 日,连接到版本 2.0.4 上的 <ARC 计算机的任何 ssh 命令将不再有效。 请升级到 az ssh 版本 >=2.0.4

ssh arc

指向 ssh 引用组的链接

  • 2025 年 5 月 21 日,版本 <2.0.4 上的任何 ssh arc 命令将不再有效。 请升级到 az ssh 版本 >=2.0.4

azext_storage_preview

storage account create

指向存储帐户引用组的链接

  • --min-tls-version 参数值TLS1_0和TLS1_1已于 2026/02/03 停用,将于 2026/03/03 中删除。

storage account update

指向存储帐户引用组的链接

  • --min-tls-version 参数值TLS1_0和TLS1_1已于 2026/02/03 停用,将于 2026/03/03 中删除。

注释

本文提供有关即将进行的重大变更的信息。 有关以前发布的重大变更,请参阅 Azure CLI 发行说明