编辑

通过

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

Introducing the Az PowerShell module

  • 项目

Overview

The Az PowerShell module is a set of cmdlets for managing Azure resources directly from PowerShell. PowerShell provides powerful features for automation that can be leveraged for managing your Azure resources, for example in the context of a CI/CD pipeline.

The Az PowerShell module is the replacement for AzureRM and is the recommended module to use for interacting with Azure.

Warning

The AzureRM PowerShell module has been officially deprecated as of February 29, 2024. Users are advised to migrate from AzureRM to the Az PowerShell module to ensure continued support and updates.

Although the AzureRM module may still function, it's no longer maintained or supported, placing any continued use at the user's discretion and risk. Please refer to our migration resources for guidance on transitioning to the Az module.

You can use the Az PowerShell module with one of the following methods:

Features

The Az PowerShell module features the following benefits:

  • Security and stability
    • Token cache encryption
    • Prevention of man-in-the-middle attack type
    • Support authentication with ADFS 2019
    • Username and password authentication in PowerShell 7
    • Support for features like continuous access evaluation
  • Support for all Azure services
    • All generally available Azure services have a corresponding supported PowerShell module
    • Multiple bug fixes and API version upgrades since AzureRM
  • New capabilities
    • Support in Cloud Shell and cross-platform
    • Can get and use access token to access Azure resources
    • Cmdlet available for advanced REST operations with Azure resources

Note

PowerShell 7.2 or higher is the recommended version of PowerShell for use with the Az PowerShell module on all platforms.

The Az PowerShell module is based on the .NET Standard library and works with PowerShell 7.2 and later on all platforms including Windows, Linux, and macOS. It's also compatible with Windows PowerShell 5.1.

We're committed to bringing Azure support to all platforms and all Az PowerShell modules are cross-platforms.

Upgrade your environment to Az

To keep up with the latest Azure features in PowerShell, you should migrate to the Az module. If you're not ready to install the Az module as a replacement for AzureRM, you have a couple of options available to experiment with Az:

  • Use a PowerShell environment with Azure Cloud Shell. Azure Cloud Shell is a browser-based shell environment that comes with the Az module installed and Enable-AzureRM compatibility aliases enabled.
  • Keep the AzureRM module installed in Windows PowerShell 5.1 and install the Az module in PowerShell 7 or later. Windows PowerShell 5.1 and PowerShell 7 and later use separate collections of modules. Follow the instructions to install the latest version of PowerShell and then install the Az module from PowerShell 7 or later.

To upgrade from an existing AzureRM install:

  1. Uninstall the Azure PowerShell AzureRM module
  2. Install the Az PowerShell module
  3. OPTIONAL: Enable compatibility mode to add aliases for AzureRM cmdlets with Enable-AzureRMAlias while you become familiar with the new command set. For more information, see the next section or Start migration from AzureRM to Az.

Migrate existing scripts from AzureRM to Az

If your scripts are still based on the AzureRM module, we have several resources to help you with the migration:

Supportability

Az is the most current PowerShell module for Azure. Issues or feature requests can be logged directly on the GitHub repository, or via Microsoft support if you have a support contract. Feature requests are implemented in the latest version of Az. Critical issues are implemented on the last two versions of Az.

Because Az PowerShell modules now have all the capabilities of AzureRM PowerShell modules and more, we've deprecated the AzureRM PowerShell modules as of February 29, 2024.

To avoid service interruptions, update your scripts that use AzureRM PowerShell modules to use Az PowerShell modules. To automatically update your scripts, follow the quickstart guide.

Data collection

Azure PowerShell collects telemetry data by default. Microsoft aggregates collected data to identify patterns of usage to identify common issues and to improve the experience of Azure PowerShell. Microsoft Azure PowerShell doesn't collect any private or personal data. For example, the usage data helps identify issues such as cmdlets with low success and helps prioritize our work.

While we appreciate the insights this data provides, we also understand that not everyone wants to send usage data. You can disable data collection with the Disable-AzDataCollection cmdlet. You can also read our privacy statement to learn more.