Introducing the new Azure PowerShell Az module

Starting in December 2018, the Azure PowerShell Az module is in general release and now the intended PowerShell module for interacting with Azure. Az offers shorter commands, improved stability, and cross-platform support. Az also offers feature parity and an easy migration path from AzureRM.

Az uses the .NET Standard library, which means it runs on PowerShell 5 and PowerShell 6. Since PowerShell 6 can run on Linux, macOS, and Windows, Azure PowerShell is now available for all platforms. Using .NET Standard allows us to unify the code base of Azure PowerShell with minimal impact on users.

Az is a new module, so the version has been reset to 1.0.0.

Upgrade to Az

It's recommended that all users upgrade to the new Az module. To do so:

Migrate existing scripts to Az

Major updates can be inconvenient. However, the Az module has a compatibility mode to help you use existing scripts while you work on updates to the new syntax. Use the Enable-AzureRmAlias cmdlet to enable the AzureRM compatibility mode. This cmdlet defines AzureRM cmdlet names as aliases for the new Az cmdlet names.

The new cmdlet names have been designed to be easy to learn. Instead of using AzureRm or Azure in cmdlet names, use Az. For example, the old command New-AzureRMVm has become New-AzVm.

For a full description of the migration process, see Migrate from AzureRM to Az.

The future of support for AzureRM

The existing AzureRM module will no longer receive new cmdlets or features. However, AzureRM is still officially maintained and will get bug fixes up through December 2020. To keep up with the latest Azure services and features, switch to the Az module.