你当前正在访问 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 入门,详细了解此模块及其功能。