在 Windows 上安裝 Azure CLI

發行項
02/04/2025

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.68.0。如需最新版本的相關資訊，請參閱版本資訊。若要尋找已安裝的版本，並查看是否需要更新，請執行 az version。

安裝或更新

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

重要

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

WinGet （Windows 套件管理員）

使用 WinGet這個 Microsoft 針對 Windows 的套件管理員，以安裝和管理 Azure CLI 的更新。 Winget 預設會在 64 位作系統上安裝 64 位 Azure CLI。

注意

根據預設，WinGet 適用於 Windows 11 和新式版本的 Windows 10。不過，它可能不會安裝在舊版 Windows 中。如需安裝指示，請參閱 winget 檔。

winget install -e --id Microsoft.AzureCLI

此選項 -e 是確保已安裝官方 Azure CLI 套件。此命令預設會安裝最新版本。若要指定版本，請將具有所需版本的新增 -v <version> 至命令。以下是範例：

winget install -e --id Microsoft.AzureCLI -v 2.66.0

Microsoft 安裝程式（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 版取得。

Microsoft安裝程式（MSI）與 PowerShell

若要使用 PowerShell 安裝 Azure CLI，請以系統管理員身分啟動 PowerShell，然後執行下列命令：

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi

這會下載並安裝適用於 Windows 的 Azure CLI 的最新 32 位安裝程式。如果您要安裝 64 位，請將 URL 變更為 https://aka.ms/installazurecliwindowsx64。如果已安裝 Azure CLI，安裝程式將會覆寫現有的版本。

若要安裝特定版本，請將 -Uri 自變數取代為下一節中所述的 URL。以下是在 PowerShell 中使用 Azure CLI 2.51.0 版 32 位安裝程序的範例：

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi

特定版本

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

Bash 與 PowerShell 之間的語法差異

雖然大部分的 Azure CLI 檔都是在 Bash 殼層中撰寫及測試，但您也可以使用 PowerShell 來安裝和執行 Azure CLI。 Bash 和 PowerShell 之間有細微的語法差異。請檢閱這些文章，以避免文稿錯誤：

使用 PowerShell 腳本語言執行 Azure CLI 的考慮
在 Azure CLI 參數中使用引號
比較 Bash、PowerShell 和 Cmd.exe在 Bash、PowerShell 和 Cmd 中瞭解 Azure CLI 語法差異的語法

在 PowerShell 中執行 Azure CLI 時，也有錯誤處理差異，以及啟用索引標籤自動完成的能力。如需詳細資訊，請參閱下列文章：

ZIP 套件

重要

此套件目前為預覽狀態。

您可以使用 ZIP 套件在 Windows 上安裝 Azure CLI。當您沒有系統管理許可權時，此套件很有用。

將封裝解壓縮到資料夾，然後使用 Cmd 或 PowerShell 執行來呼叫 Azure CLI <unzipped folder path>\bin\az.cmd。

如果您想要直接執行 az 命令，請遵循下列步驟，將 Azure CLI 新增至 PATH 環境變數。

開啟 [開始] 選單並搜尋 environment variables。按一下 Edit the system environment variables。
按一下 Environment Variables... 按鈕。
在方塊中 User varibles for <username> ，選取 Path 並按下 Edit... 按鈕。
New按兩下按鈕，並將新增<unzipped folder path>\bin至清單。
重新啟動終端機。 您現在應該能夠執行 az 命令。

特定版本

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

若要下載特定版本的 ZIP 套件，請變更 URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip中的版本區段。

例如，若要安裝 Azure CLI 2.57.0 版的 64 位 ZIP，您的 URL 會是 https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip。

您可以在 Azure CLI 版本資訊中找到可用的 Azure CLI 版本。 ZIP 套件可從 2.57.0 版取得。只有 64 位可用。

執行 Azure CLI

安裝之後，請關閉並重新開啟任何使用中的終端機視窗。 使用 Windows 命令提示字元或 PowerShell 的 az 命令來執行 Azure CLI。常見的第一個步驟是檢查有效的訂閱。

az account show

安裝疑難排解

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

未設定PATH變數

此問題最常見的原因是安裝之後，使用中的終端機視窗尚未重新啟動。關閉並重新開啟任何使用中的終端機視窗。

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/

如需詳細資訊，請參閱 Azure CLI 疑難解答指南中的 Proxy 後置工作。

回應時間緩慢

請參閱遷移至 64 位 Azure CLI

在 PowerShell 中啟用 Tab 鍵自動完成

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

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

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

將下列程式代碼新增至 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
}

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

更新 Azure CLI

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

az upgrade

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

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

遷移至 64 位 Azure CLI

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

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

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

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

解除安裝

如果您決定卸載 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 登入

共用方式為

在 Windows 上安裝 Azure CLI

安裝或更新

WinGet （Windows 套件管理員）

Microsoft 安裝程式（MSI）

最新版本

特定版本

Microsoft安裝程式（MSI）與 PowerShell

特定版本

Bash 與 PowerShell 之間的語法差異

ZIP 套件

最新版本

特定版本

執行 Azure CLI

安裝疑難排解

未設定PATH變數

Proxy 封鎖連線

回應時間緩慢

在 PowerShell 中啟用 Tab 鍵自動完成

更新 Azure CLI

遷移至 64 位 Azure CLI

解除安裝

拿掉資料

後續步驟

其他資源

共用方式為

在 Windows 上安裝 Azure CLI

安裝或更新

WinGet （Windows 套件管理員）

Microsoft 安裝程式 （MSI）

最新版本

特定版本

Microsoft安裝程式 （MSI） 與 PowerShell

特定版本

Bash 與 PowerShell 之間的語法差異

ZIP 套件

最新版本

特定版本

執行 Azure CLI

安裝疑難排解

未設定PATH變數

Proxy 封鎖連線

回應時間緩慢

在 PowerShell 中啟用 Tab 鍵自動完成

更新 Azure CLI

遷移至 64 位 Azure CLI

解除安裝

拿掉資料

後續步驟

其他資源

Microsoft 安裝程式（MSI）

Microsoft安裝程式（MSI）與 PowerShell