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

在 Windows 上安装 Azure CLI

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 下手动进行安装。

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

安装或更新

MSI 和 ZIP 可分发版用于在 Windows 上安装或更新 Azure CLI。 MSI 将更新所有现有版本,因此在使用 MSI 安装程序之前,无需卸载当前版本。

重要

安装完成后,需要关闭并重新打开任何活动的终端窗口,才能使用 Azure CLI。

最新版本

下载并安装最新版本的 Azure CLI。 当安装程序询问是否可以对计算机进行更改时,请选择“是”框。

如果之前已安装 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 键将命令名称、命令组名称、参数和某些参数值自动插入到命令行中。

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

  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 上提出问题

代理阻止连接

如果由于代理阻止连接而不能下载 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/

迁移到 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 位 MSI 并重新安装 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 并使其变得用户友好。 如果你在发现 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.binC:\Users\<username>\.azure\msal_token_cache.json 中删除其数据。

后续步骤

你已在 Windows 上安装了 Azure CLI,接下来请了解登录的不同方法。