Introducing the new Azure PowerShell Az module

Starting in November 2018, the Azure PowerShell Az module is available for full public preview. Az offers shorter commands, improved stability, and supports Windows, macOS, and Linux. 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.x and PowerShell 6.x. Since PowerShell 6.x can run on Linux, macOS, and Windows, that means Az is 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. The first stable release will be 1.0, but the module has feature parity with AzureRm as of November 2018.

Upgrade to Az

It's recommended that 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 when Az version 1.0 is released in December 2018. However, AzureRM is still officially maintained and will get bug fixes. To keep up with the latest Azure services and features, you should switch to the Az module.