在 macOS 上安裝 Azure CLI

發行項
01/10/2024

Azure 命令列介面（CLI）允許使用互動式命令行提示或腳本，透過終端機執行命令。您可以在 macOS 電腦上本機安裝 Azure CLI。 macOS 上的 Azure CLI 允許使用互動式命令行提示或腳本，透過終端機執行各種命令。

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

Azure CLI 的目前版本是 2.63.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_PROXY 且 HTTPS_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，請簡短流覽其功能和常見命令。

開始使用 Azure CLI

共用方式為