你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Windows 上安装 Azure CLI

项目
11/14/2024

Azure 命令行接口 (CLI) 是一种跨平台命令行工具，可在 Windows 计算机上本地安装。你可以使用适用于 Windows 的 Azure CLI 连接到 Azure 并对 Azure 资源执行管理命令。适用于 Windows 的 Azure CLI 还可以通过 Azure Cloud Shell 在浏览器中使用，或者从 Docker 容器内部运行。

对于 Windows，Azure CLI 是通过 MSI 或 ZIP 包安装的，通过 Windows 命令提示符（CMD）或 PowerShell 访问 CLI。为适用于 Linux 的 Windows 子系统 (WSL) 执行安装时，可以安装适用于 Linux 分发版的包。请参阅安装主页，获取受支持包管理器的列表，或者了解如何在 WSL 下手动进行安装。

在 Windows 中安装 Azure CLI 有四种方法：

Azure CLI 的当前版本为 2.66.0。有关最新版本的信息，请参阅发行说明。若要查找已安装的版本并查看是否需要更新，请运行 az 版本。

安装或更新

MSI 和 ZIP 可分发版用于在 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 shell 中编写和测试的，但你也可以使用 PowerShell 安装和运行 Azure CLI。 Bash 和 PowerShell 之间存在细微的语法差异。查看以下文章以避免脚本错误：

使用 PowerShell 脚本语言运行 Azure CLI 的注意事项
在 Azure CLI 参数中使用引号
比较 Bash、PowerShell 和 Cmd.exe 在 Bash、PowerShell 和 Cmd 中的 Learn Azure CLI 语法差异中的语法

在 PowerShell 中运行 Azure CLI 时，还存在错误处理差异以及启用 Tab 自动补全的功能。请参阅以下文章获取详细信息：

winget

还可以使用 winget（Microsoft 的适用于 Windows 的包管理器）来安装和管理 Azure CLI 的更新。

注意

winget 在 Windows 11 和新式版本的 Windows 10 中默认提供。但是，它可能不会在较旧版本的 Windows 中安装。有关安装说明，请参阅 winget 文档。

winget install -e --id Microsoft.AzureCLI

-e 选项用于确保安装了官方 Azure CLI 包。此命令默认安装最新版本。若要指定版本，请将带有所需版本的 -v <version> 添加到命令中。

重要

此包目前处于预览阶段。

可以使用 ZIP 包在 Windows 上安装 Azure CLI。如果没有管理权限，则此包非常有用。

将包解压缩到文件夹，然后使用 Cmd 或 PowerShell 运行 <unzipped folder path>\bin\az.cmd来调用 Azure CLI。

如果想要直接运行 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 了。

安装故障排除

以下是在 Windows 上安装 Azure CLI 时出现的一些常见问题。如果遇到的问题未在本文中列出，请在 GitHub 上提出问题。

未设置 PATH 变量

此问题的最常见原因是安装后尚未重启活动终端窗口。关闭并重新打开任何活动终端窗口。

代理阻止连接

如果由于代理阻止连接而不能下载 MSI 安装程序，请确保已正确配置代理。对于 Windows 10，这些设置是在 Settings > Network & Internet > Proxy 窗格中管理的。如果要了解所需的设置，或者在计算机可能是配置管理型计算机或需要高级设置的情况下，请与系统管理员联系。

重要

这些设置也需要能够通过 CLI（从 PowerShell 或命令提示符）访问 Azure 服务。在 PowerShell 中，请使用以下命令执行此操作：

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

为了获取 MSI，代理必须允许与以下地址之间的 HTTPS 连接：

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

有关详细信息，请参阅 Azure CLI 故障排除指南中的代理背后的工作。

响应时间缓慢

请参阅迁移到 64 位 Azure CLI

在 PowerShell 中启用 Tab 自动补全

Tab 自动补全，也称为“Azure CLI 补全器”，提供输入自动补全功能，以提供提示、启用发现和加快条目输入速度。可以通过按 Tab 键将命令名称、命令组名称、参数和某些参数值自动插入到命令行中。

Tab 自动补全在 Azure Cloud Shell 和大多数 Linux 发行版中默认启用。从 Azure CLI 版本 2.49 开始，可以在 PowerShell 中为 Azure CLI 启用 Tab 自动补全。执行以下步骤：

创建或编辑存储在变量 $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 位 MSI 并重新安装 32 位 MSI。如果已备份 32 位扩展文件夹，请在更改后将其还原（重命名）。

卸载

如果你决定卸载 Azure CLI，我们会很遗憾。在卸载之前，请使用 az feedback 命令告诉我们在哪些方面需要改进或修复。我们的目标是消除 Azure CLI 中的 bug 并使其变得用户友好。如果你在发现 bug 后提出 GitHub 问题，我们将十分感激。

通过 Windows 中的“应用和功能”列表卸载 Azure CLI。若要卸载：

平台	说明
Windows 11	“开始”>“设置”>“应用”>“已安装的应用”
Windows 10	启动 > 设置 > 应用应用 > 和功能
Windows 8 和 Windows 7	“开始”>“控制面板”>“程序”>“卸载程序”

进入此屏幕后，请在程序搜索栏中键入 Azure CLI。要卸载的程序列为“Microsoft CLI 2.0 for Azure”。选择此应用程序，然后选择 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

安装或更新

最新版本

特定版本

运行 Azure CLI

安装故障排除

未设置 PATH 变量

代理阻止连接

响应时间缓慢

在 PowerShell 中启用 Tab 自动补全

更新 Azure CLI

迁移到 64 位 Azure CLI

卸载

删除数据

后续步骤

其他资源