在 Linux 上安裝 Azure CLI

本文說明如何在Linux上安裝 Azure CLI。 從頁面頂端的選項中，為您的散發套件選取適當的套件管理員。 建議您使用Linux發行版的套件管理員，但您可以選取 [安裝腳本 ] 選項，在Linux上手動安裝 Azure CLI。

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

開始之前

• Azure CLI 2.38.1 （於 2023 年 9 月 1 日發行）是 RHEL 7 和 Centos 7 上支援的最新版本，並將繼續收到安全性修正，直到操作系統生命週期結束為止。 Microsoft 未提供這些散發套件的其他更新或錯誤修正。

• Microsoft 會繼續開發和支援 Azure CLI 和 Linux 安裝腳本。

• yum如果您使用不支援套件管理員的 dnf Linux系統，請使用套件管理員。

安裝 Azure CLI

若要安裝 Azure CLI，請遵循下列步驟：

1. 匯入 Microsoft 存放庫金鑰。

   sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
   

2. 針對 RHEL 9 或 CentOS Stream 9，新增存放 packages-microsoft-com-prod 庫：

   sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm
   

   針對 RHEL 8 或 CentOS Stream 8，新增存放 packages-microsoft-com-prod 庫：

   sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
   

   針對 RHEL 7 或 CentOS 7，新增存放 azure-cli 庫：

   echo -e "[azure-cli]
   name=Azure CLI
   baseurl=https://packages.microsoft.com/yumrepos/azure-cli
   enabled=1
   gpgcheck=1
   gpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repo
   

3. 使用 dnf install 命令進行安裝。

   sudo dnf install azure-cli
   

安裝特定版本

您必須先如先前所示設定 azure-cli 存放庫資訊。 您可以在 Azure CLI 版本資訊中找到可用的版本。

1. 若要使用 命令檢視可用的版本：

   dnf list --showduplicates azure-cli
   

2. 若要安裝特定版本：

   sudo dnf install azure-cli-<version>-1.el7
   

更新 Azure CLI

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

az upgrade

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

您也可以使用 dnf update 命令來更新 Azure CLI。

sudo dnf update azure-cli

卸載 Azure CLI

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

1. 從系統移除套件。

   sudo dnf remove azure-cli
   

2. 如果您不打算重新安裝 CLI，請移除存放庫資訊。

   sudo rm /etc/yum.repos.d/azure-cli.repo
   

3. 如果您未使用任何其他 Microsoft 套件，請移除簽署金鑰。

   MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
   sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
   

拿掉資料

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

rm -rf ~/.azure

疑難排解

以下是使用 dnf安裝 時所見的一些常見問題。 如果您遇到此處未涵蓋的問題， 請在 GitHub 上提出問題。

在 RHEL 7.6 或其他沒有 Python 3 的系統上安裝

如果您能夠，請使用正式的套件支援 python 3.6+ ，將系統升級至版本。 否則，您必須先安裝 python3 套件，然後安裝 Azure CLI 而不需相依性。

您可以使用下列命令，以從來源建置來下載並安裝 Azure CLI 安裝文稿 python 3.6 ：

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

您也可以逐步執行：

首先，Azure CLI 需要 SSL 1.1+ 且您需要從來源建置 openssl 1.1 ，才能建置 python3：

sudo dnf install gcc gcc-c++ make ncurses patch wget tar zlib zlib-devel -y
# build openssl from source
cd ~
wget https://www.openssl.org/source/openssl-1.1.1d.tar.gz
tar -xzf openssl-1.1.1d.tar.gz
cd openssl-1.1.1d
./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl
make
sudo make install
# configure shared object lookup directory so that libssl.so.1.1 can be found
echo "/usr/local/ssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1d.conf
# reload config
sudo ldconfig -v

然後從來源建置 Python 3：

PYTHON_VERSION="3.6.9"
PYTHON_SRC_DIR=$(mktemp -d)
wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
./configure --prefix=/usr --with-openssl=/usr/local/ssl
make
sudo make install

最後，請遵循安裝指示的步驟 1 和 2 來新增 Azure CLI 存放庫。 您現在可以下載套件並加以安裝，而不需相依性。

注意

如果尚未安裝 dnf 下載外掛程式，則執行下列程式代碼時會發生 command not found 錯誤。 使用 dnf install 'dnf-command(download)' 來安裝 dnf 下載外掛程式。

sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm

或者，您也可以使用 另一個存放庫來安裝 Python 3。 如果您已設定 python3 ，但仍收到錯誤 python3: command not found，請使用此方法。 請確定它已包含在您的路徑中。

scl enable rh-python36 bash

Proxy 封鎖連線

如果您因為 Proxy 而無法連線到外部資源，請確定您已在殼層中正確設定 HTTP_PROXY 和 HTTPS_PROXY 變數。 您必須連絡系統管理員，以瞭解要用於這些 Proxy 的主機和埠。

許多 Linux 程式會使用這些變數中的值，並在安裝程式期間使用。 若要設定這些值：

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

重要

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

您也可以明確設定 dnf 為一律使用此 Proxy。 請確定下列幾行會出現在 的 [main]/etc/dnf/dnf.conf區段底下：

[main]
# ...
proxy=http://[proxy]:[port] # If your proxy requires https, change http->https
proxy_username=[username] # Only required for basic auth
proxy_password=[password] # Only required for basic auth

若要從我們的存放庫取得 Microsoft 簽署金鑰和套件，您的 Proxy 必須允許 HTTPS 連線至下列位址：

• https://packages.microsoft.com

CLI 無法在 Windows 子系統 Linux 版 上安裝或執行

由於 Windows 子系統 Linux 版 （WSL） 是 Windows 平臺上的系統呼叫轉譯層，因此您在嘗試安裝或執行 Azure CLI 時可能會遇到錯誤。 CLI 依賴 WSL 中可能有 Bug 的某些功能。 如果您在安裝 CLI 時遇到錯誤，很有可能是 WSL 的問題，而不是 CLI 安裝程式的問題。

若要針對 WSL 安裝進行疑難解答，並可能解決問題：

• 如果可以，請在 Linux 機器或 VM 上執行相同的安裝程式，以查看其是否成功。 如果這樣做，您的問題可能與 WSL 相關。 若要在 Azure 中啟動 Linux VM，請參閱 Azure 入口網站 檔中的建立 Linux VM。
• 請確定您執行的是最新版本的 WSL。 若要取得最新版本， 請更新您的 Windows 10 安裝。
• 檢查任何可能解決您問題的 WSL 開啟問題。 通常有關於如何解決此問題的建議，或問題修正所在版本的相關信息。
• 如果您的問題沒有任何現有問題， 請向WSL 提出新的問題，並確定您盡可能包含盡可能多的資訊。

如果您繼續在 WSL 上安裝或執行時發生問題，請考慮 安裝適用於 Windows 的 CLI。

開始之前

• Azure CLI 2.38.1 （於 2023 年 9 月 01 日發行）是 SUSE Linux Enterprise Server （SLES） 和 OpenSUSE （Leap） 上支援的最新版本，並將繼續接收安全性修正，直到 2024 年 6 月底為止。 Microsoft 未提供這些散發套件的其他更新或錯誤修正。

• Microsoft 會繼續開發和支援 Azure CLI 和 Linux 安裝腳本。 SUSE 會維護並支援 SUSE/OpenSUSE 存放庫所提供的套件。

• 在 Azure 中，以 Azure Marketplace 映射為基礎的 SUSE 和 OpenSUSE 虛擬機已安裝 Azure CLI。

安裝 Azure CLI

若要在 SUSE/OpenSUSE 上安裝 Azure CLI，請選擇下列其中一種方法：

1. 使用 SUSE/OpenSUSE 存放庫中 SUSE 所提供的企業套件。

2. 使用 [安裝腳本（任何）] 索引標籤中所述的安裝方法。

3. 從 Microsoft 存放庫安裝

從 SUSE 或 OpenSUSE 存放庫安裝

Azure CLI 的 RPM 套件取決於 python3 套件。

sudo zypper install -y azure-cli

使用安裝文稿進行安裝

您可以使用 [安裝腳本] 選項，在 Linux 的任何版本上手動安裝 Azure CLI。

如果您要 使用此方法更新 至最新版本，請務必先卸載舊版，以及您可能已針對該版本新增的任何存放庫。

從 Microsoft 存放庫安裝

若要使用 Microsoft 存放庫安裝最新版的 Azure CLI，請遵循下列步驟。

（此套件已經過測試 SLES 15 和 OpenSUSE Leap 15.1）

1. 安裝 curl：

   sudo zypper install -y curl
   

2. 匯入 Microsoft 存放庫金鑰：

   sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
   

3. 建立本機 azure-cli 存放庫資訊：

   sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
   

4. zypper更新套件索引並安裝：

   sudo zypper install --from azure-cli azure-cli
   

   輸入 2 會忽略部分相依性，以繼續安裝。

安裝特定版本

您必須先如先前所示設定 azure-cli 存放庫資訊。 您可以在 Azure CLI 版本資訊中找到可用的版本。

1. 使用此指令檢視可用的版本：

   zypper search --details --match-exact azure-cli
   

2. 若要安裝特定版本：

   sudo zypper install --from azure-cli azure-cli=<version>-1.el7
   

更新 Azure CLI

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

az upgrade

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

您也可以使用 zypper update 命令來更新套件。

sudo zypper refresh
sudo zypper update azure-cli

卸載 Azure CLI

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

1. 從系統移除套件。

   sudo zypper remove -y azure-cli
   

2. 如果您不打算重新安裝 CLI，請移除存放庫資訊。

   sudo zypper removerepo azure-cli
   

3. 如果您沒有使用其他 Microsoft 套件，請移除 Microsoft 簽署密鑰。

   MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
   sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
   

拿掉資料

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

rm -rf ~/.azure

疑難排解

以下是使用 zypper安裝 時所見的一些常見問題。 如果您遇到此處未涵蓋的問題， 請在 GitHub 上提出問題。

不使用 Python 3 安裝

重要

Azure CLI 的 RPM 套件取決於 python3 套件。 在您的系統上，這可能是早於 Python 3.6.x 需求的 Python 版本。 如果這會影響您，請尋找取代 python3 套件。

請注意，Python 2 已於 2020 年 1 月 1 日終止生命週期 （EOL），且將不再收到更新。 自 2.1.0 版起，Azure CLI 已放棄對 Python 2.7 的支援。 較新版本的 CLI 可能無法使用 Python 2.7 正確執行。

OpenSUSE 15 VM 上的 NotImplementedError

OpenSUSE 15 VM 具有預安裝的 Azure CLI，版本 2.0.45 已過期，且有問題 az login。 請先移除此版本及其相依性，再遵循 安裝 指示來新增最新的 Azure CLI：

sudo zypper rm -y --clean-deps azure-cli

如果您更新 Azure CLI 而不移除 2.0.45 版的相依性，其舊相依性可能會影響最新版的 Azure CLI。 您必須將舊版新增至其相依性，然後移除 azure-cli 其相依性：

# The package name may vary on different system version, run 'zypper --no-refresh info azure-cli' to check the source package format
sudo zypper install --oldpackage azure-cli-2.0.45-4.22.noarch

sudo zypper rm -y --clean-deps azure-cli

在沒有 Python 3.6 的 SLES 12 或其他系統上安裝

在 SLES 12 上，預設 python3 套件為 3.4，且 Azure CLI 不支援。 您可以先遵循安裝指示的步驟 1-3 來新增存放azure-cli庫。 然後從來源建置更高版本 python3 。 最後，您可以下載 Azure CLI 套件並加以安裝，而不需相依性。

您可以使用下列一個命令，根據上述步驟來安裝或更新 Azure CLI。 腳本會在 底下 /usr/local/azcli 安裝 Python 3.8，並將 的 az 別名設定為 PATH=/usr/local/azcli/bin:$PATH az，讓 Azure CLI 使用它。 您也可以下載文本，並根據您的需求加以修改。 例如，您可以變更 Python 版本或安裝位置。

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

第一次安裝時，請記得執行下列命令來啟動別名：

source ~/.bashrc

Proxy 封鎖連線

如果您因為 Proxy 而無法連線到外部資源，請確定您已在殼層中正確設定 HTTP_PROXY 和 HTTPS_PROXY 變數。 您必須連絡系統管理員，以瞭解要用於這些 Proxy 的主機和埠。

許多 Linux 程式會使用這些變數中的值，並在安裝程式期間使用。 若要設定這些值：

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

重要

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

您也可以明確設定 zypper （透過 yast2） 一律使用此 Proxy。 若要這樣做，請以超級使用者身分執行 yast2 proxy 命令，並填寫窗體中呈現的資訊。 如果您的系統上有可用的視窗管理員，您也可以使用 Network Services > Proxy 中的 YaST Control Center窗格。

如需進階設定或詳細資訊，請參閱 OpenSUSE Proxy 組態檔

若要取得 Microsoft 簽署金鑰並從我們的存放庫取得套件，您的 Proxy 必須允許 HTTPS 連線到下列位址：

• https://packages.microsoft.com
• https://download.opensuse.org

CLI 無法在 Windows 子系統 Linux 版 上安裝或執行

由於 Windows 子系統 Linux 版 （WSL） 是 Windows 平臺上的系統呼叫轉譯層，因此您在嘗試安裝或執行 Azure CLI 時可能會遇到錯誤。 CLI 依賴 WSL 中可能有 Bug 的某些功能。 如果您在安裝 CLI 時遇到錯誤，很有可能是 WSL 的問題，而不是 CLI 安裝程式的問題。

若要針對 WSL 安裝進行疑難解答，並可能解決問題：

• 如果可以，請在 Linux 機器或 VM 上執行相同的安裝程式，以查看其是否成功。 如果這樣做，您的問題可能與 WSL 相關。 若要在 Azure 中啟動 Linux VM，請參閱 Azure 入口網站 檔中的建立 Linux VM。
• 請確定您執行的是最新版本的 WSL。 若要取得最新版本， 請更新您的 Windows 10 安裝。
• 檢查任何可能解決您問題的 WSL 開啟問題。 通常有關於如何解決此問題的建議，或問題修正所在版本的相關信息。
• 如果您的問題沒有任何現有問題， 請向WSL 提出新的問題，並確定您盡可能包含盡可能多的資訊。

如果您繼續在 WSL 上安裝或執行時發生問題，請考慮 安裝適用於 Windows 的 CLI。

SSL 憑證問題

當計算機上的憑證中斷或過期時，您可能會收到錯誤，指出 curl 無法驗證伺服器的合法性，因此無法建立安全連線。 更新您的憑證以更正問題。

sudo zypper update-ca-certificates

開始之前

• 套件 apt 管理員包含 Azure CLI 的x86_64和 ARM64 套件，這些套件已在下列發行版上進行測試。

  Distribution	版本
  Ubuntu	20.04 LTS （焦點福薩）， 22.04 （傑米水母）
  Debian	10 （布斯特）， 11 （公牛）， 12 （書蟲）

• Ubuntu 20.04 （Focal Fossa） 和 20.10 （Groovy Gorilla） 包含一個套件，其中包含存放azure-cli庫所提供的universe版本2.0.81。 此套件已過期，不建議使用。 如果已安裝此套件，請先移除套件，再繼續執行 命令 sudo apt remove azure-cli -y && sudo apt autoremove -y。 如需 的詳細資訊 apt remove，請參閱 Ubuntu 套件管理 或 詢問 ubuntu。

安裝 Azure CLI

在您的系統上安裝 Azure CLI 有兩個選項。 您可以下載執行安裝命令的安裝腳本，也可以自行在逐步程式中執行安裝命令。 這裡提供這兩種方法：

選項 1：使用一個命令安裝

安裝 Azure CLI 最簡單的方式是透過 Azure CLI 小組維護的腳本。 此文稿會在一個步驟中執行所有安裝命令。 此腳本會透過 curl 直接下載並傳送至 以 bash 安裝 CLI。

如果您想要在執行之前自行檢查腳本的內容，請先使用 下載腳本，然後在您慣用 curl 的文本編輯器中檢查它。

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

選項 2：逐步安裝指示

如果您想要逐步安裝程式，請完成下列步驟來安裝 Azure CLI。

1. 取得安裝程式所需的套件：

   sudo apt-get update
   sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
   

2. 下載並安裝 Microsoft 簽署金鑰：

   sudo mkdir -p /etc/apt/keyrings
   curl -sLS https://packages.microsoft.com/keys/microsoft.asc |
     sudo gpg --dearmor -o /etc/apt/keyrings/microsoft.gpg
   sudo chmod go+r /etc/apt/keyrings/microsoft.gpg
   

3. 新增 Azure CLI 軟體存放庫：

   AZ_DIST=$(lsb_release -cs)
   echo "Types: deb
   URIs: https://packages.microsoft.com/repos/azure-cli/
   Suites: ${AZ_DIST}
   Components: main
   Architectures: $(dpkg --print-architecture)
   Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources
   

4. 更新存放庫資訊並安裝 azure-cli 套件：

   sudo apt-get update
   sudo apt-get install azure-cli
   

安裝特定版本

如先前所示設定存放 azure-cli 庫資訊。 您可以在 Azure CLI 版本資訊中找到可用的版本。

1. 檢視 Azure CLI 的可用版本。

   apt-cache policy azure-cli
   

2. 安裝特定版本。

   # Obtain the currently installed distribution
   AZ_DIST=$(lsb_release -cs)
   
   # Store an Azure CLI version of choice
   AZ_VER=2.51.0
   
   # Install a specific version
   sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}
   

   若要安裝不含變數的特定版本，請取代顯示的 Azure CLI 版本和 Linux 發行版名稱：

   sudo apt-get install azure-cli=2.51.0-1~bullseye
   

如果您收到找不到套件 azure-cli 的錯誤訊息，則不會設定存放azure-cli庫資訊。 請遵循選項 2：逐步安裝指示中提供的步驟。

如果您收到找不到 azure-cli 版本 x.xx.x-1~distributionName 的錯誤訊息，請使用 lsb_release -cs 來尋找您正在執行的散發套件。

更新 Azure CLI

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

az upgrade

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

您也可以使用 apt-get upgrade 來更新 CLI 套件。 此命令會升級系統上尚未變更相依性的所有已安裝套件。

sudo apt-get update && sudo apt-get upgrade

若要僅升級 CLI，請使用 apt-get install。

sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli

卸載 Azure CLI

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

1. 使用 apt-get remove卸載 ：

   sudo apt-get remove -y azure-cli
   

2. 如果您不打算重新安裝 CLI，請移除 Azure CLI 存放庫資訊：

   sudo rm /etc/apt/sources.list.d/azure-cli.sources
   

3. 如果您未從 Microsoft 使用其他套件，請移除簽署金鑰：

   sudo rm /etc/apt/keyrings/microsoft.gpg
   

4. 移除任何不需要的套件：

   sudo apt autoremove
   

拿掉資料

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

rm -rf ~/.azure

疑難排解

以下是使用 apt安裝 時所見的一些常見問題。 如果您遇到此處未涵蓋的問題， 請在 GitHub 上提出問題。

套件azure-cli支援 CLI 2.46.0 版的 ARM64 架構。

Ubuntu 20.04 （Focal）/WSL 上沒有模塊問題

如果您在手動安裝指示的步驟 3 或使用腳本的步驟 3 中安裝 azure-cli Azure Focal CLI 軟體存放庫，您可能會遇到如未使用名為 'decorator' 或 'antlr4' 的模組之類的問題，因為您安裝的套件已過期azure-cli 2.0.81。focal/universe 先執行 sudo apt remove azure-cli -y && sudo apt autoremove -y來移除它，然後依照上述 指示 安裝最新的 azure-cli 套件。

lsb_release不會傳回正確的基底散發版本

某些 Ubuntu 或其他 Debian 衍生的發行版（例如 Linux Mint）可能不會從 lsb_release傳回正確的版本名稱。 這個值用於安裝程式，以判斷要安裝的套件。 如果您知道散發套件衍生自的 Ubuntu 或 Debian 版本代碼名稱，您可以在新增存放庫時手動設定AZ_REPO值。 否則，請查閱您的散發資訊，以瞭解如何判斷基底散發程式代碼名稱，並設定 AZ_REPO 為正確的值。

散發套件沒有套件

有時候，更新的 Azure CLI 套件在發行版發行后無法立即取得。 Azure CLI 的設計目的是要復原未來版本的相依性，並盡可能依賴其中少數版本。 如果您的基底散發套件沒有可用的套件，請嘗試先前發行版的套件。

若要嘗試舊版發行版的套件，請在新增存放庫時手動設定 的值AZ_REPO。 針對Ubuntu散發套件，請使用最新的 jammy 存放庫：

AZ_REPO="jammy"

針對 Debian 散發套件，請使用最新的 bookworm 存放庫：

AZ_REPO="bookworm"

重要

不支援在Ubuntu B生和Debian Buster之前發行的發行版。

基本 OS （EOS） 無法安裝 Azure CLI

EOS 無法安裝 Azure CLI，因為 lsb_release 會傳 HERA回 ，這是 EOS 版本名稱。 解決方案是修正檔案 /etc/apt/sources.list.d/azure-cli.sources ，並將 變更 Suites: hera 為 Suites: bionic。

來源檔案內容：

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

修改過的檔案內容

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Proxy 封鎖連線

如果您因為 Proxy 而無法連線到外部資源，請確定您已在殼層中正確設定 HTTP_PROXY 和 HTTPS_PROXY 變數。 您必須連絡系統管理員，以瞭解要用於這些 Proxy 的主機和埠。

許多 Linux 程式會使用這些變數中的值，並在安裝程式期間使用。 若要設定這些值：

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

重要

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

您也可以明確設定 apt 為一律使用此 Proxy。 請確定下列幾行會出現在 中的組態檔中apt/etc/apt/apt.conf.d/。 建議您使用現有的全域組態檔、現有的 Proxy 組態檔或 99local，40proxies但請遵循系統管理需求。

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

如果您的 Proxy 未使用基本身份驗證，請 移除[username]:[password]@ Proxy URI 的部分。 如果您需要 Proxy 設定的詳細資訊，請參閱官方 Ubuntu 檔：

• apt.conf man 頁面
• Ubuntu Wiki - apt-get howto

若要取得 Microsoft 簽署金鑰並從我們的存放庫取得套件，您的 Proxy 必須允許 HTTPS 連線到下列位址： 'https://packages.microsoft.com.

CLI 無法在 Windows 子系統 Linux 版 上安裝或執行

由於 Windows 子系統 Linux 版 （WSL） 是 Windows 平臺上的系統呼叫轉譯層，因此您在嘗試安裝或執行 Azure CLI 時可能會遇到錯誤。 CLI 依賴 WSL 中可能有 Bug 的某些功能。 如果您在安裝 CLI 時遇到錯誤，很有可能是 WSL 的問題，而不是 CLI 安裝程式的問題。

若要針對 WSL 安裝進行疑難解答，並可能解決問題：

• 如果可以，請在 Linux 機器或 VM 上執行相同的安裝程式，以查看其是否成功。 如果這樣做，您的問題可能與 WSL 相關。 若要在 Azure 中啟動 Linux VM，請參閱 Azure 入口網站 檔中的建立 Linux VM。
• 請確定您執行的是最新版本的 WSL。 若要取得最新版本， 請更新您的 Windows 10 安裝。
• 檢查任何可能解決您問題的 WSL 開啟問題。 通常有關於如何解決此問題的建議，或問題修正所在版本的相關信息。
• 如果您的問題沒有任何現有問題， 請向WSL 提出新的問題，並確定您盡可能包含盡可能多的資訊。

如果您繼續在 WSL 上安裝或執行時發生問題，請考慮 安裝適用於 Windows 的 CLI。

安裝 Azure CLI

RPM 會透過 CBL-Mariner 發行給 Azure Linux。 套件azure-cli支援 CLI 2.46.0 版的 ARM64 架構。

若要安裝 Azure CLI，請遵循下列步驟：

1. 安裝官方 Microsoft 策劃的一組受信任的跟證書：

   sudo tdnf install ca-certificates
   

2. 安裝 Azure CLI：

   sudo tdnf install azure-cli
   

安裝特定版本

您可以在 Azure CLI 版本資訊中找到可用的版本。

若要使用 命令檢視可用的版本：

tdnf list azure-cli

若要安裝特定版本：

sudo tdnf install azure-cli-<version>-1

更新 Azure CLI

使用 tdnf update 命令更新 Azure CLI：

sudo tdnf update azure-cli

卸載 Azure CLI

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

從您的系統移除套件：

sudo tdnf remove azure-cli

拿掉資料

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

rm -rf ~/.azure

開始之前

強烈建議使用套件管理員安裝 CLI。 套件管理員可確保您一律會取得最新的更新，並保證 CLI 元件的穩定性。 在手動安裝之前，請檢查並查看您的發行版是否有套件。

CLI 需要下列軟體：

• Python 3.6.x、3.7.x 或 3.8.x。
• libffi
• OpenSSL 1.0.2

安裝或更新 Azure CLI

安裝和更新 Azure CLI 都需要重新執行安裝腳本。

curl -L https://aka.ms/InstallAzureCli | bash

您也可以下載文稿並在本機執行。 您可能需要重新啟動殼層，才能讓變更生效。

卸載 Azure CLI

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

直接從安裝時選擇的位置刪除檔案，以卸載 CLI。 預設安裝位置是使用者的主目錄（$HOME）。

1. 拿掉已安裝的 CLI 檔案。

   rm -r <install location>/lib/azure-cli
   rm <install location>/bin/az
   

2. 修改檔案 $HOME/.bash_profile 以移除下列這一行：

   <install location>/lib/azure-cli/az.completion
   

3. bash如果使用 或 zsh，請重載殼層的命令快取。

   hash -r
   

拿掉資料

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

rm -rf ~/.azure

疑難排解

以下是手動安裝期間看到的一些常見問題。 如果您遇到此處未涵蓋的問題， 請在 GitHub 上提出問題。

不使用 Python 3 安裝

自 2.1.0 版起，Azure CLI 已放棄對 Python 2.7 的支援。 在您的系統上，可能有 Python 版本會預先要求 Python 3.6.x。 尋找取代 python3 套件。

curl “Object Moved” 錯誤

如果您收到與 curl 參數相關的 -L 錯誤，或包含「已移動物件」文字的錯誤訊息，請嘗試使用完整的 URL，而不是 aka.ms 重新導向：

curl https://azurecliprod.blob.core.windows.net/install | bash

az 找不到命令

如果您在使用 bash 或 zsh安裝之後無法執行命令，請嘗試清除殼層的命令哈希快取，並檢查問題是否已解決。

hash -r

如果您在安裝之後未重新啟動殼層，也可能會發生此問題。 請確定命令的位置 az 位於 您的 $PATH中。 命令的位置 az 為

 <install path>/bin

Proxy 封鎖連線

如果您因為 Proxy 而無法連線到外部資源，請確定您已在殼層中正確設定 HTTP_PROXY 和 HTTPS_PROXY 變數。 您必須連絡系統管理員，以瞭解要用於這些 Proxy 的主機和埠。

許多 Linux 程式會使用這些變數中的值，並在安裝程式期間使用。 若要設定這些值：

# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]

# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]

重要

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

若要取得安裝文稿，您的 Proxy 必須允許 HTTPS 連線到下列位址：

• https://aka.ms/
• https://azurecliprod.blob.core.windows.net/
• https://pypi.python.org
• 散發套件管理員所使用的端點（如果有的話）用於核心套件

CLI 無法在 Windows 子系統 Linux 版 上安裝或執行

由於 Windows 子系統 Linux 版 （WSL） 是 Windows 平臺上的系統呼叫轉譯層，因此您在嘗試安裝或執行 Azure CLI 時可能會遇到錯誤。 CLI 依賴 WSL 中可能有 Bug 的某些功能。 如果您在安裝 CLI 時遇到錯誤，很有可能是 WSL 的問題，而不是 CLI 安裝程式的問題。

若要針對 WSL 安裝進行疑難解答，並可能解決問題：

• 如果可以，請在 Linux 機器或 VM 上執行相同的安裝程式，以查看其是否成功。 如果這樣做，您的問題可能與 WSL 相關。 若要在 Azure 中啟動 Linux VM，請參閱 Azure 入口網站 檔中的建立 Linux VM。
• 請確定您執行的是最新版本的 WSL。 若要取得最新版本， 請更新您的 Windows 10 安裝。
• 檢查任何可能解決您問題的 WSL 開啟問題。 通常有關於如何解決此問題的建議，或問題修正所在版本的相關信息。
• 如果您的問題沒有任何現有問題， 請向WSL 提出新的問題，並確定您盡可能包含盡可能多的資訊。

如果您繼續在 WSL 上安裝或執行時發生問題，請考慮 安裝適用於 Windows 的 CLI。

後續步驟

現在您已安裝 Azure CLI，請簡短流覽其功能和常見命令。

開始使用 Azure CLI