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

Az PowerShell 模块简介

概述

Az PowerShell 模块是一组 cmdlet，用于直接从 PowerShell 管理 Azure 资源。 PowerShell 提供强大的自动化功能，你可利用这些功能管理 Azure 资源，例如在 CI/CD 管道的上下文中。

Az PowerShell 模块是 AzureRM 的替代方案，是推荐用于与 Azure 交互的模块。

警告

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

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

可以将以下方法之一与 Az PowerShell 模块结合使用：

• 安装 Az PowerShell 模块。
• 使用 Azure Cloud Shell。
• 使用 Az PowerShell Docker容器。

功能

Az PowerShell 模块具有以下优点：

• 安全与稳定
  • 令牌缓存加密
  • 防止中间人攻击类型
  • 支持向 ADFS 2019 进行身份验证
  • PowerShell 7 中的用户名和密码身份验证
  • 支持连续访问评估等功能
• 支持所有 Azure 服务
  • 所有正式发布的 Azure 服务都有相应受支持的 PowerShell 模块
  • 自 AzureRM 以来推出了多个 bug 修复和 API 版本升级
• 新功能
  • Cloud Shell 中以及跨平台的支持
  • 可以获取和使用访问令牌来访问 Azure 资源
  • 可用于对 Azure 资源执行高级 REST 操作的 cmdlet

注意

在各大平台中，建议将 Azure Az PowerShell 模块与 PowerShell 7.2 或更高版本一起使用。

Az PowerShell 模块基于 .NET Standard 库，适用于所有平台（包括 Windows、Linux 和 macOS）上的 PowerShell 7.2 及更高版本。 它还与 Windows PowerShell 5.1 兼容。

我们会努力将 Azure 支持引入所有平台，所有 Az PowerShell 模块都是跨平台的。

将环境升级到 Az

为了使用 PowerShell 中的最新 Azure 功能，应迁移到 Az 模块。 如果尚未做好安装 Az 模块来替换 AzureRM 的准备，可以通过多个可用的选项来试验 Az：

• 将 PowerShell 环境与 Azure Cloud Shell 配合使用。 Azure Cloud Shell 是一种基于浏览器的 shell 环境，该环境安装了 Az 模块并启用了 Enable-AzureRM 兼容性别名。
• 始终在 Windows PowerShell 5.1 中安装 AzureRM 模块，而在 PowerShell 7 或更高版本中安装 Az 模块。 Windows PowerShell 5.1 与 PowerShell 7 及更高版本使用不同的模块集合。 按说明安装最新版 PowerShell，然后从 PowerShell 7 或更高版本安装 Az 模块。

若要从现有的 AzureRM 安装升级，请执行以下操作：

1. 卸载 Azure PowerShell AzureRM 模块
2. 安装 Az PowerShell 模块
3. 可选：熟悉新的命令集后，通过 Enable-AzureRMAlias 启用兼容模式为 AzureRM cmdlet 添加别名。 有关详细信息，请参阅下一部分或开始从 AzureRM 迁移到 Az。

将现有脚本从 AzureRM 迁移到 Az

如果你的脚本仍基于 AzureRM 模块，可借助我们提供的多个资源进行迁移：

• 入门：从 AzureRM 迁移到 Az
• 从 AzureRM 到 Az 1.0.0 的中断性变更的完整列表
• Enable-AzureRmAlias cmdlet

可支持性

Az 是适用于 Azure 的最新 PowerShell 模块。 可以直接在 GitHub 存储库上或通过 Microsoft 支持（如果订立了支持合约）来记录问题或功能请求。 功能请求在 Az 的最新版本中实现。 关键问题在最近两个 Az 版本中实现。

由于 Az PowerShell 模块现在已具有 AzureRM PowerShell 模块的所有功能及更多功能，因此我们已从 2024 年 2 月 29 日起开始弃用 AzureRM PowerShell 模块。

若要避免服务中断，请更新脚本：将使用 AzureRM PowerShell 模块的脚本更新为使用 Az PowerShell 模块。 若要自动更新脚本，请按照快速入门指南操作。

数据收集

Azure PowerShell 会默认收集遥测数据。 Microsoft 聚合收集的数据以识别使用模式、识别常见问题并改善 Azure PowerShell 的体验。 Microsoft Azure PowerShell 不会收集任何私有或个人数据。 例如，使用情况数据可帮助确定问题（如 cmdlet 成功率较低），并帮助确定工作优先级。

虽然此数据提供的见解非常有用，但我们也了解并非人人都愿意发送使用情况数据。 可以通过 Disable-AzDataCollection cmdlet 禁用数据收集。 还可以阅读我们的隐私声明，了解更多信息。