你当前正在访问 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 模块与以下方法之一配合使用：

功能

Az PowerShell 模块具有以下优势：

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

注释

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

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

我们致力于将 Azure 支持带到所有平台，并且所有 Az PowerShell 模块都是跨平台的。

将您的环境升级到 Microsoft Azure

若要跟上 PowerShell 中最新的Azure功能，应迁移到 Az 模块。 如果尚未准备好将 Az 模块安装为 AzureRM 的替代项，可以使用几个选项来试验 Az：

  • 将 PowerShell 环境与 Azure Cloud Shell 配合使用。 Azure Cloud Shell 是一个基于浏览器的命令行环境，其中已安装 Az 模块并启用了兼容别名功能。
  • 在 powerShell 5.1 Windows中安装 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 等问题，并帮助确定工作优先级。

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

  • Last updated on