Azure PowerShell – Cross-platform “Az” module replacing “AzureRM”

There is a new Azure PowerShell module, built to harness the power of PowerShell Core and Cloud Shell, and maintain compatibility with PowerShell 5.1. Its name is Az. Az ensures that PowerShell and PowerShell Core users can get the latest Azure tooling in every PowerShell, on every platform. Az also simplifies and normalizes Azure PowerShell cmdlet and module names. Az ships in Azure Cloud Shell and is available from the PowerShell Gallery. 

For complete details on the release, timeline, and compatibility features, please see GitHub announcement page.

Az module features

• Az is a replacement for AzureRM and AzureRM.Netcore.
• Az runs on PowerShell 5.1 and PowerShell Core.
• Az is always up to date with the latest tooling for Azure services.
• Az ships in Cloud Shell.
• Az shortens and normalizes cmdlet names. All cmdlets use “Az” as their noun prefix.
• Az will simplify and normalize module names. Data plane and management plane cmdlets for each service will use the same Az module.
• Az ships with new cmdlets to enable script compatibility with AzureRM (Enable/Disable-AzureRmAlias).

Supported platforms

• PowerShell 5.1 – Windows 7 or greater with .Net Framework 4.7.2 or greater installed
• PowerShell Core 6.0 – Windows, Mac OS, Linux
• PowerShell Core 6.1 – Windows, Mac OS, Linux

Installing Az

You can install Az from the PowerShell gallery.

     PS C:> Install-Module Az

You should not install Az side-by-side with AzureRM. Remove all AzureRM modules before installing Az.

Compatibility with AzureRM

If you would like to run scripts developed for AzureRM using Az, use the Enable/Disable-AzureRmAlias cmdlets to add or remove aliases from AzureRM cmdlets to Az cmdlets.

Enable-AzureRmAlias [-Module ] [-Scope Process | CurrentUser | LocalMachine]

Adds AzureRM cmdlet aliases for the given modules (or all modules if no modules are specified) to the current session (default), all sessions for the current user, or all session on the machine.

Disable-AzureRmAlias [-Module ] [-Scope Process | CurrentUser | LocalMachine]

Removes AzureRM cmdlet aliases for the given modules (or all modules if no modules are specified) from the current session (default), all sessions for the current user, or all session on the machine.

Learn more about the compatibility features in Az. 

More information

• Az is currently in preview, and will replace AzureRM as the recommended module for all Azure PowerShell tooling later this year. Learn more about the product roadmap.
• Az is Open Source and uses the Azure PowerShell source code repository on GitHub.
• If you have questions, comments, or issues with the new module, please tell us about them on GitHub.