在 Windows 上安裝 Azure CLI

  • 發行項

Azure 命令列介面 （CLI） 是可在 Windows 電腦上本機安裝的跨平臺命令行工具。 您可以使用適用於 Windows 的 Azure CLI 連線到 Azure，並在 Azure 資源上執行系統管理命令。 您也可以透過 Azure Cloud Shell 從瀏覽器使用適用於 Windows 的 Azure CLI，或從 Docker 容器內執行。

針對 Windows，Azure CLI 是透過 MSI 或 ZIP 套件安裝，可讓您透過 Windows 命令提示字元或 PowerShell 存取 CLI。 當您針對 Windows 子系統 Linux 版 （WSL） 執行安裝時，Linux 發行版可以使用套件。 如需支援的套件管理員清單，或如何在 WSL 底下手動安裝，請參閱主要安裝頁面。

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

安裝或更新

MSI 和 ZIP 可散發套件用於在 Windows 上安裝或更新 Azure CLI。 使用 MSI 安裝程式之前，您不需要卸載目前的版本，因為 MSI 會更新任何現有的版本。

重要

安裝完成之後，您必須 關閉並重新開啟任何使用中的終端機視窗，才能使用 Azure CLI。

最新版本

下載並安裝最新版的 Azure CLI。 當安裝程式詢問計算機是否可以進行變更時，請選取 [是] 方塊。

Azure CLI 的最新 MSI （32 位）

Azure CLI 的最新 MSI （64 位）

如果您先前已安裝 Azure CLI，則執行 32 位或 64 位 MSI 將會覆寫現有的安裝。

特定版本

如果您想要的話，您可以使用 URL 下載特定版本的 Azure CLI。

若要下載特定版本的 MSI 安裝程式，請變更 URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi （32 位） 或 https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi （64 位） 中的版本區段。

例如，若要安裝 Azure CLI 2.51.0 版的 32 位 MSI，您的 URL 會是 https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi。 對應的 64 位安裝會是 https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi。

您可以在 Azure CLI 版本資訊中找到可用的 Azure CLI 版本。 64 位 MSI 可從 2.51.0 版取得。

執行 Azure CLI

您現在可以從 Windows 命令提示字元或 PowerShell 使用 az 命令來執行 Azure CLI。

在 PowerShell 中啟用 Tab 鍵自動完成

Tab 鍵自動完成，也稱為「Azure CLI 完成項」，可在輸入上完成以提供提示、啟用探索並加速輸入輸入。 按下 Tab 鍵，即可自動將命令名稱、命令組名、參數和特定參數值插入命令行。

預設會在 Azure Cloud Shell 和大部分 Linux 發行版中啟用 Tab 鍵自動完成。 從 Azure CLI 2.49 版開始，您可以在 PowerShell 中啟用 Azure CLI 的索引標籤完成。 執行下列步驟:

  1. 建立或編輯儲存在變數 $PROFILE中的配置檔。 最簡單的方式是在PowerShell中執行 notepad $PROFILE 。 如需詳細資訊，請參閱如何建立設定檔和設定檔與執行原則。

  2. 將下列程式代碼新增至 PowerShell 設定檔：

    Register-ArgumentCompleter -Native -CommandName az -ScriptBlock {
    param($commandName, $wordToComplete, $cursorPosition)
    $completion_file = New-TemporaryFile
    $env:ARGCOMPLETE_USE_TEMPFILES = 1
    $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
    $env:COMP_LINE = $wordToComplete
    $env:COMP_POINT = $cursorPosition
    $env:_ARGCOMPLETE = 1
    $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
    $env:_ARGCOMPLETE_IFS = "`n"
    $env:_ARGCOMPLETE_SHELL = 'powershell'
    az 2>&1 | Out-Null
    Get-Content $completion_file | Sort-Object | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
    }
    Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
}

  3. 若要在功能表中顯示所有可用的選項，請將 新增 Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete 至您的PowerShell配置檔。

疑難排解

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

Proxy 封鎖連線

如果您因為 Proxy 封鎖連線而無法下載 MSI 安裝程式，請確定您已正確設定 Proxy。 針對 Windows 10，這些設定會在窗格中進行管理 Settings > Network & Internet > Proxy 。 請連絡系統管理員以取得必要的設定，或針對計算機可能受設定管理或需要進階設定的情況。

重要

這些設定也需要能夠透過 CLI 從 PowerShell 或命令提示字元存取 Azure 服務。 在 PowerShell 中，您可以使用下列命令來執行此動作：

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

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

  • https://aka.ms/
  • https://azcliprod.blob.core.windows.net/

遷移至 64 位 Azure CLI

從 2.51.0 開始，Azure CLI 也提供 64 位 MSI，以提升效能。

請遵循下列步驟來移轉至 Azure CLI 64 位：

  1. 執行 az --version來檢查您目前的 CLI 版本和已安裝的延伸模組。
  2. 需要重新安裝擴充功能。 建議您重新命名目前擴充資料夾 %userprofile%\.azure\cliextensions 的備份，以防您選擇還原回 32 位。 當您重新安裝擴充功能時，會自動建立此資料夾。
  3. 下載並安裝最新的 64 位安裝程式，如安裝或更新中所述。 32 位 MSI 將會自動卸載。
  4. 執行 az extension add --name <extension> --version <version>來安裝擴充功能。 如果您不想手動重新安裝擴充功能，Azure CLI 會提示您在第一次使用時安裝擴充功能。 如需安裝擴充功能的詳細資訊，請參閱 如何安裝擴充功能。

如果您在移轉之後發生問題，您可以卸載 64 位，然後重新安裝 32 位 MSI。 如果您已備份 32 位擴充資料夾，請在變更之後還原 （重新命名） 您的延伸模組資料夾。

更新 Azure CLI

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

az upgrade

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

如果您使用 ZIP 散發套件，請刪除舊的安裝資料夾，並將新版本解壓縮到 相同的位置。

解除安裝

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

您可以從 Windows 的 [應用程式和功能] 清單中卸載 Azure CLI。 若要卸載：

平台 Instructions
Windows 11 啟動 > 設定 > 已安裝的應用程式>
Windows 10 開始 > 設定 > 系統>應用程式與功能
Windows 8 和 Windows 7 [開始] > [控制台] > [程式集] > [解除安裝程式]

在此畫面上輸入 Azure CLI 到程式搜尋列中一次。 要卸載的程式會列為 適用於 Azure 的 Microsoft CLI 2.0。 選取此應用程式，然後選取 Uninstall 按鈕。

拿掉資料

如果您不打算重新安裝 Azure CLI，請從 C:\Users\<username>\.azure\msal_token_cache.bin 或 C:\Users\<username>\.azure\msal_token_cache.json移除其數據。

後續步驟

既然您已在 Windows 上安裝 Azure CLI，請瞭解登入的不同方式。

使用 Azure CLI 登入