你当前正在访问 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"):

请回答 Yes 或 Yes 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 入门，详细了解此模块及其功能。