共用方式為


在 macOS 上安裝 Azure CLI

Azure 命令列介面 (CLI) 是可在 macOS 電腦上本機安裝的跨平臺命令行工具。 您可以使用 Azure CLI 連線到 Azure,並使用互動式命令行提示字元或腳本,在 Azure 資源上執行系統管理命令。

針對macOS平臺,使用 homebrew套件管理員安裝 Azure CLI。 Homebrew 可讓您輕鬆地將 CLI 更新保持在最新狀態。 CLI 套件已在macOS 10.9版和更新版本上進行測試。

Azure CLI 的目前版本是 2.67.0。 如需最新版本的相關資訊,請參閱版本資訊。 若要尋找已安裝的版本,並查看是否需要更新,請執行 az version

使用 Homebrew 安裝

Homebrew 是管理 CLI 安裝的最簡單方式。 它提供方便的方式來安裝、更新和卸載。 如果您的系統上沒有 homebrew 可用, 請先安裝 homebrew 再繼續。

您可以藉由更新 brew 存放庫資訊,然後執行 install 命令,在 macOS 上安裝 Azure CLI:

brew update && brew install azure-cli

疑難排解

如果您在透過 Homebrew 安裝 CLI 時遇到問題,以下是一些常見的錯誤。 如果您遇到此處未涵蓋的問題, 請在 GitHub 上提出問題。

完成無法運作

Azure CLI 的 Homebrew 公式會在 Homebrew 管理的完成目錄中安裝名為 az 的完成檔案(預設位置為 /usr/local/etc/bash_completion.d/)。 若要啟用完成,請遵循 Homebrew 這裡的指示

針對 Zsh,將下列兩行新增至檔案 .zshrc 底部,然後儲存並重載您的 Zsh 配置檔。

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

找不到 Python 或已安裝的套件

在homebrew安裝期間可能會有次要版本不符或其他問題。 CLI 不會使用 Python 虛擬環境,因此會依賴尋找已安裝的 Python 版本。 可能的修正是安裝並重新連結 Homebrew 的 python@3.10 相依性。

brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10

已安裝 CLI 1.x 版

如果已安裝過期的版本,可能是因為homebrew快取過時。 請遵循更新指示。

Proxy 封鎖連線

除非您已正確設定為使用 Proxy,否則可能無法從 Homebrew 取得資源。 請遵循 Homebrew Proxy 設定指示。

重要

如果您位於 Proxy 後方, HTTP_PROXYHTTPS_PROXY 必須設定為使用 CLI 連線到 Azure 服務。 如果您未使用基本身份驗證,建議您在檔案中 .bashrc 匯出這些變數。 請一律遵循您企業的安全策略和系統管理員的需求。

若要從 Homebrew 取得瓶裝資源,您的 Proxy 必須允許 HTTPS 連線到下列位址:

  • https://formulae.brew.sh
  • https://homebrew.bintray.com

更新

CLI 會定期更新 Bug 修正、改善、新功能和預覽功能。 新版本大約每三周提供一次。

從 2.11.0 版開始,Azure CLI 會提供工具內命令來更新至最新版本。

az upgrade

依預設,此命令也會更新所有已安裝的延伸模組。 如需更多 az upgrade 選項,請參閱 命令參考頁面。 針對 2.11.0 之前的 Azure CLI 版本,請重新安裝 ,如安裝 Azure CLI 中所述進行更新。

您也可以更新本機 Homebrew 存放庫資訊,然後升級 azure-cli 套件。

brew update && brew upgrade azure-cli

解除安裝

如果您決定卸載 Azure CLI,很抱歉,請前往。 卸載之前,請使用 az feedback 命令讓我們知道可以改善或修正的專案。 我們的目標是讓 Azure CLI 無 Bug 且方便使用者使用。 如果您發現錯誤,如果您 提出 GitHub 問題,我們很感激。

使用 homebrew 卸載 azure-cli 套件。

brew uninstall azure-cli

拿掉資料

如果您不打算重新安裝 Azure CLI,請移除其數據。

rm -rf ~/.azure

其他安裝方法

如果您無法使用 homebrew 在您的環境中安裝 Azure CLI,則可以使用 Linux 的手動指示。 此程序並未正式維護為與 macOS 相容。 一律建議使用 Homebrew 之類的套件管理員。 只有在您沒有其他可用的選項時,才使用手動安裝方法。

如需手動安裝指示,請參閱 手動在Linux上安裝 Azure CLI。

後續步驟

既然您已在macOS上安裝 Azure CLI,請簡短流覽其功能和常見命令。