在 Windows 上安裝 Azure CLI

發行項
09/23/2023

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

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

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

安裝或更新

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

重要

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

特定版本

如果您想要的話，您可以使用 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 版取得。

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 參數中使用引號
使用 JMESPath 比較查詢命令輸出中的 CMD、PowerShell 和 Bash 語法

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

winget

您也可以使用 winget 適用于 Windows 的 Microsoft 套件管理員，安裝及管理 Azure CLI 的更新。

注意

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

winget install -e --id Microsoft.AzureCLI

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

執行 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 的索引標籤完成。請遵循下列步驟：

建立或編輯儲存在變數 $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 設定檔。

疑難排解

以下是在 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 位：

執行 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

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

az upgrade

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

解除安裝

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

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

平台	Instructions
Windows 11	啟動 > 已安裝的應用程式設定 > 應用程式 >
Windows 10	啟動 > 設定 > System > Apps & 功能
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

安裝或更新

最新版本

特定版本

PowerShell

特定版本

Bash 與 PowerShell 之間的差異

winget

執行 Azure CLI

在 PowerShell 中啟用 Tab 鍵自動完成

疑難排解

Proxy 封鎖連線

遷移至 64 位 Azure CLI

更新 Azure CLI

解除安裝

移除資料

後續步驟

其他資源

其他資源