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

如何更新 Azure CLI

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

手动更新

自版本 2.11.0 起，Azure CLI 提供了用于更新到最新版本的工具内命令。

az upgrade

默认情况下，此命令还将更新所有已安装的扩展。 有关更多 az upgrade 选项，请参阅命令参考页面。 对于 2.11.0 之前的 Azure CLI 版本，请按照安装 Azure CLI 中的说明重新安装以进行更新。

只要安装受支持，就可在 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