如何更新 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