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

在 Windows 上安装 Azure PowerShell

  • 项目

Az PowerShell 模块是一个汇总模块。 安装 Az PowerShell 模块会下载正式发布的模块并使其 cmdlet 可供使用。

Az PowerShell 模块的建议安装方法和 PowerShell 版本：

  • 从 PowerShell 库安装
  • 与 PowerShell 版本 7 或更高版本结合使用

本文介绍如何通过 PowerShell 库在 Windows 上安装 Az PowerShell 模块。

先决条件

  • 从 PowerShell 运行以下命令以确定 PowerShell 版本：

    $PSVersionTable.PSVersion

  • 确定是否安装了 AzureRM PowerShell 模块：

    Get-Module -Name AzureRM -ListAvailable

    重要

    如果已安装 AzureRM PowerShell 模块，在继续操作之前，请参阅 Az 和 AzureRM 共存。

  • 将 PowerShell 执行策略设置为“远程签名”或“更低限制”

    • 检查 PowerShell 执行策略：

      Get-ExecutionPolicy -List

    • 将 PowerShell 执行策略设置为远程签名：

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    若要详细了解执行策略，请参阅 about_Execution_Policies。

安装

使用 Install-Module cmdlet 安装 Az PowerShell 模块：

Install-Module -Name Az -Repository PSGallery -Force

更新 Az PowerShell 模块

使用 Update-Module 更新到最新版本的 Az PowerShell 模块：

Update-Module -Name Az -Force

使用 Update-Module 更新 Az PowerShell 模块不会从系统中删除旧版 Az PowerShell 模块。

卸载

若要删除 Az PowerShell 模块，请参阅卸载 Azure PowerShell 模块。

本文介绍如何使用 MSI 安装程序在 Windows 上安装 Az PowerShell 模块。 MSI 安装程序是为 PowerShell 库可能被防火墙阻止或需要脱机安装程序的环境提供的。

重要

MSI 安装选项只能用于安装 Az PowerShell 模块，以便与 Windows PowerShell 5.1 配合使用。

先决条件

  • 从 PowerShell 运行以下命令以确定 PowerShell 版本：

    $PSVersionTable.PSVersion

  • 确定是否安装了 AzureRM PowerShell 模块

    Get-Module -Name AzureRM -ListAvailable

    重要

    如果已安装 AzureRM PowerShell 模块，在继续操作之前，请参阅 Az 和 AzureRM 共存。

  • 更新到 Windows PowerShell 5.1

  • 安装 .NET Framework 4.7.2 或更高版本

  • 将 PowerShell 脚本执行设置为远程签名或减小限制性

    • 检查 PowerShell 执行策略：

      Get-ExecutionPolicy -List

    • 将 PowerShell 执行策略设置为远程签名：

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    若要详细了解执行策略，请参阅 about_Execution_Policies。

安装和更新

GitHub 上提供了 Azure PowerShell 的 MSI 包：

  1. 访问 github.com/Azure/azure-powershell/releases
  2. 找到最新的 Az PowerShell 模块。 它们按时间顺序列出，不含名称。 例如： 9.5.0
  3. 请向下滚动到补丁备注的底部，单击“资产”旁边的箭头以显示 MSI 选项。
  4. 单击选择的 Az-Cmdlets MSI 开始下载

安装程序会自动删除使用 MSI 安装的旧版 Az PowerShell 模块。 MSI 包在 "${env:ProgramFiles}\WindowsPowerShell\Modules" 中安装模块

登录

若要开始使用 Az PowerShell 模块管理 Azure 资源，请启动 PowerShell 会话并运行 Connect-AzAccount 以登录到 Azure：

Connect-AzAccount

使用 Azure 帐户登录凭据登录到打开的浏览器窗口。

需要在每个新启动的 PowerShell 会话中重复此步骤。 若要了解如何跨 PowerShell 会话保持 Azure 登录状态，请参阅 Azure PowerShell 上下文对象。

疑难解答

有关 Az PowerShell 模块常见安装问题的解决方案，请参阅排查 Az PowerShell 模块的安装问题。

提供反馈

若要提交有关 Az PowerShell 模块的问题，请参阅：在 GitHub 上提问

若要从 PowerShell 会话内提供反馈，请使用 Send-Feedback cmdlet。

后续步骤

若要详细了解如何使用 Az PowerShell 模块管理 Azure 资源，请参阅 Azure PowerShell 入门。