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

使用 PowerShellGet 在 Windows 上安装 Azure PowerShell

警告

AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可运行,但不再受到维护或支持,任何继续使用的行为都由用户自行决定并自行承担风险。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

本文介绍了使用 PowerShellGet 为 Windows 安装适用于 PowerShell 5.x 的 Azure PowerShell 模块的步骤。 PowerShellGet 和模块管理是安装 Azure PowerShell 的首选方法,但是如果希望使用 Web 平台安装程序或 MSI 包进行安装,请参阅其他安装方法

此版 Azure PowerShell 不支持 Azure 经典部署模型。 若要获取经典部署的支持,请按安装 Azure PowerShell 服务管理模块中的说明操作。

重要

macOS 或 Linux 不支持 AzureRM 模块。 若要在这些平台上使用 Azure PowerShell cmdlet,请安装 Az 模块

要求

从 Azure PowerShell 版本 6.0 开始,Azure PowerShell 需要 PowerShell 版本 5.0。 若要查看在计算机上运行的 PowerShell 的版本,请运行以下命令:

$PSVersionTable.PSVersion

如果版本已过时,请参阅升级现有的 Windows PowerShell

重要

本文档中介绍的模块 AzureRM 使用 .NET Framework。 这使得它与使用 .NET Core 的 PowerShell 6.0 兼容。 如果使用的是 PowerShell 6.0,请遵循适用于 macOS 和 Linux 的安装说明

安装 Azure Powershell 模块

需要提升的权限才能通过 PowerShell 库安装模块。 若要安装 Azure PowerShell,请在已提升权限的会话中运行以下命令:

Install-Module -Name AzureRM -AllowClobber

注意

如果使用的 NuGet 版本低于 2.8.5.201,系统会提示下载并安装最新版本的 NuGet。

默认情况下,PowerShell 库未配置为 PowerShellGet 的受信任存储库。 首次使用 PSGallery 时会看到以下提示:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the Set-PSRepository cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

请回答 YesYes to All 继续安装。

AzureRM 模块是 Azure PowerShell cmdlet 的汇总模块。 安装它时,系统会下载所有可用的 Azure 资源管理器模块并使其 cmdlet 可供使用。

登录

若要开始使用 Azure PowerShell,请通过 Azure 凭据登录。

# Connect to Azure with an interactive dialog for sign-in
Connect-AzureRmAccount

注意

如果已禁用模块自动加载,则需使用 Import-Module AzureRM 手动导入模块。 考虑到模块的构造方式,这可能需要几秒钟时间。

需要在每个新启动的 PowerShell 会话中重复这些步骤。 若要了解如何跨 PowerShell 会话保持 Azure 登录状态,请参阅跨 PowerShell 会话保持用户凭据

更新 Azure PowerShell 模块

可以通过运行 Update-Module 来更新 Azure PowerShell 安装。 此命令不卸载以前的版本。

Update-Module -Name AzureRM

若要从系统中删除旧版 Azure PowerShell,请参阅卸载 Azure PowerShell 模块

使用多个版本的 Azure PowerShell

可以安装多个版本的 Azure PowerShell。 若要检查是否安装了多个版本的 Azure PowerShell,请使用以下命令:

Get-InstalledModule -Name AzureRM -AllVersions |
  Select-Object -Property Name, Version

若要删除 Azure PowerShell 的某个版本,请参阅卸载 Azure PowerShell 模块

如果使用本地 Azure Stack 资源、运行旧版 Windows,或使用 Azure 经典部署模型,则可能需要多个版本。 若要安装旧版本,请在安装时提供 -RequiredVersion 参数。

# Install version 2.3.0 of Azure PowerShell
Install-Module -Name AzureRM -RequiredVersion 2.3.0

加载 Azure PowerShell 模块时,默认加载最新版本。 若要加载其他版本,请指定 RequiredVersion 参数。

# Load version 2.3.0 of Azure PowerShell
Import-Module -Name AzureRM -RequiredVersion 2.3.0

提供反馈

如果在使用 Azure Powershell 时发现了 bug,请在 GitHub 上提出问题。 若要从命令行提供反馈,请使用 Send-Feedback cmdlet。

后续步骤

若要开始使用 Azure PowerShell,请参阅 Azure PowerShell 入门,详细了解此模块及其功能。