您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的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 安装的,因此你可通过 Windows 命令提示符 (CMD) 或 PowerShell 访问 CLI。 为适用于 Linux 的 Windows 子系统 (WSL) 安装时,可以安装适用于 Linux 分发版的包。 请参阅安装主页,获取受支持包管理器的列表,或者了解如何在 WSL 下手动进行安装。

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

安装或更新

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

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

Azure CLI 当前版本

下载并安装 Azure CLI 的当前版本。 安装完成后,需要关闭并重新打开所有活动的 Windows 命令提示符或 PowerShell 窗口,才能使用 Azure CLI。

Azure CLI beta 版本

Azure CLI 的 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 处打开浏览器页,然后输入终端中显示的授权代码。

    如果没有可用的 Web 浏览器或 Web 浏览器无法打开,请通过 az login --use-device-code 使用设备代码流。

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

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

故障排除

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

卸载

如果你决定卸载 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,请从 C:\Users\<username>\.azure 中删除其数据。

后续步骤

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