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.x and PowerShell 6.x. Since PowerShell 6.x 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:
- RECOMMENDED: Uninstall the Azure PowerShell AzureRM module
- Install the Azure PowerShell Az module
- Enable compatibility mode to add aliases for AzureRM cmdlets with
Enable-AzureRMAliaswhile you become familiar with the new command set. Only enable aliases if you do not have AzureRM installed.
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
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.