在 Windows 上安装 Azure CLI

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

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

安装或更新

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

当安装程序询问是否可以对计算机进行更改时,请单击“是”框。

Azure CLI 当前版本

下载并安装 Azure CLI 的当前版本。

Azure CLI beta 版本

Azure CLI 的 beta 版本支持你在当前版本中找到的所有 CLI 命令。 beta 版本是从 Azure CLI 发布版中的迁移,因为我们即将弃用 AAD 身份验证平台 (v1.0)。 Microsoft 标识平台 (v2.0) 是新的身份验证方法,可供 Azure CLI beta 版本使用。 建议你提前试用 beta 版本。

要详细了解 Azure CLI beta 版本,请查看发行说明

Important

该 beta 版本不保证质量达到产品级别,因此不得在生产环境中使用。

下载并安装 Azure CLI 的 beta 版本。

运行 Azure CLI

现在可以通过 Windows 命令提示符或 PowerShell 使用 az 命令运行 Azure CLI 了。 PowerShell 提供了 Windows 命令提示符所不能提供的一些 Tab 键补全功能。 若要登录,请运行 az login 命令。

  1. 运行 login 命令。

    az login
    

    如果 CLI 可以打开默认浏览器,它将这样做并加载 Azure 登录页。

    否则,请在 https://aka.ms/devicelogin 处打开浏览器页,然后输入终端中显示的授权代码。

    Note

    请先运行 az cloud set -n AzureChinaCloud 更改云环境,然后才能在 Azure 中国中使用 Azure CLI。若要切换回 Azure 公有云,请再次运行 az cloud set -n AzureCloud

  2. 在浏览器中使用帐户凭据登录。

若要详细了解不同的身份验证方法,请参阅使用 Azure CLI 登录

故障排除

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

代理阻止连接

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

Important

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

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

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

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

卸载

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

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

平台 Instructions
Windows 10 “开始”>“设置”>“应用”
Windows 8 和 Windows 7 “开始”>“控制面板”>“程序”>“卸载程序”

进入此屏幕后,请在程序搜索栏中键入 Azure CLI 。 要卸载的程序列为“Microsoft CLI 2.0 for Azure”。 选择此应用程序,然后单击 Uninstall 按钮。

后续步骤

现在你已经安装了 Azure CLI,下面简要介绍其功能和常用命令。