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:
- Uninstall the Azure PowerShell AzureRM module
- Install the Azure PowerShell Az module
- Enable compatibility mode for AzureRM with
Enable-AzureRMAliaswhile you become familiar with the new command set.
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
in cmdlet names, use
Az. For example, the old command
New-AzureRmVm has become
For a full description of the migration process, see Migrate from AzureRM to Az.
The future of support for AzureRM
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