通过

你当前正在访问 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 交互的模块。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 建议用户从 AzureRM 迁移到 Az PowerShell 模块，以确保持续支持和更新。

尽管 AzureRM 模块仍然可能正常运行，但它已不再维护或提供支持，继续使用将由用户自行决定并承担风险。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

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

Features

Az PowerShell 模块具有以下优势：

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

注释

PowerShell 7.2 或更高版本是建议的 PowerShell 版本，可用于所有平台上的 Az PowerShell 模块。

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 是基于浏览器的 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 模块，我们有几个资源可帮助你进行迁移：

可支持性

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 等问题，并帮助确定工作优先级。

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