您现在访问的是微软AZURE全睃版技术文档网站,若需覝访问由世纪互蝔违蝥的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

如何更新 Azure CLI

可依靠包管理器在 Windows、macOS 和 Linux 环境中更新 Azure CLI 的本地安装(请参阅每个平台特定的安装说明中的 Update 部分)。 CLI 还提供工具内命令来进行手动或自动升级。

手动更新

CLI 提供了一个工具内的命令用于更新到最新版本:

az upgrade

备注

az upgrade 命令是在 2.11.0 版本中添加的,不能在 2.11.0 之前的版本中使用。 可以按照安装 Azure CLI 中重新安装以更新旧版本。

默认情况下,此命令还将更新所有已安装的扩展。 有关更多 az upgrade 选项,请参阅命令参考页面

只要安装受支持,就可在 Windows、macOS 和一些 Linux 发行版上使用 az upgrade。 它仅支持升级到最新版本。 如果你在通过 Azure Cloud Shell 运行 Azure CLI,那么你很可能已在使用最新的 Azure CLI 安装。 如果不是由次要 bug 修复版本的临时发布引起的,则需要等待 Azure Cloud Shell 的下一次生成,因为 Azure Cloud Shell 不支持 az upgrade

如果 azure-cli 已是最新版本,那么运行 az upgrade 将会检查并更新所有已安装的扩展

自动更新

默认情况下,对 Azure CLI 禁用自动升级。 如果你想要跟上最新版本,可通过配置启用自动升级。

az config set auto-upgrade.enable=yes

Azure CLI 将定期检查新版本;一旦更新可用,它就将在任何命令完成运行之后提示你进行升级。

如果命令被分配给某个变量或在自动化流中,那么升级期间的提示消息和输出消息可能打断命令结果。 为了避免中断,可使用下列配置来允许在不确认的情况下自动进行更新且仅在升级期间显示警告和错误。

az config set auto-upgrade.prompt=no

默认情况下,还将更新所有已安装扩展。 可通过配置禁用扩展更新。

az config set auto-upgrade.all=no

备注

请等待 az upgrade 完成,然后继续到下一组命令,除非新版本的 CLI(和扩展)可能存在中断性变更。

如果你决定不再对保持命令脚本运行运行之类的情况使用自动更新功能,则可通过配置将其关闭。

az config set auto-upgrade.enable=no