Install Azure PowerShell on macOS or Linux

For non-Windows platforms, it's possible to run Azure PowerShell in PowerShell Core v6. This version of PowerShell is built for use on any platform that supports .NET Core. To work with these platforms, there's a .NET Standard version of Azure PowerShell available.


At this time, both PowerShell Core v6 and Azure PowerShell for .NET Core are still in beta. Support for these products is limited. If you have problems or discover bugs, please file an issue on GitHub.

Install PowerShell Core

The installation instructions for PowerShell Core are different for macOS and most Linux distributions. Detailed instructions can be found in the following articles:

Install Azure PowerShell for .NET Core

PowerShell Core comes with the PowerShellGet module already installed. Installation of modules in PowerShell requires elevated privileges, so you'll need to start your session as superuser:

sudo pwsh

To install Azure PowerShell, run the following command:

Install-Module Az


The AzureRM module detailed in other articles is not built for .NET Core and will not work with PowerShell Core. The Az modules contain command aliases for all AzureRM cmdlets, so all of the documentation for AzureRM applies.

By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. The first time you use the PSGallery you see the following prompt:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the Set-PSRepository cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Answer Yes or Yes to All to continue with the installation.

Sign in

To start working with Azure PowerShell, you need to load Az into your PowerShell session with the Import-Module cmdlet, and then sign in with your Azure credentials. Importing a module does not require elevated privileges.

# Import the module into the PowerShell session
Import-Module Az
# Connect to Azure with an interactive dialog for sign-in

You'll need to repeat these steps for every new PowerShell session you start. Automatically importing the Az module requires setting up a PowerShell profile, which you can learn about in About Profiles. On macOS and Linux, you should work with your profile through the $Profile environment variable. To learn how to persist your Azure sign-in across sessions, see Persist user credentials across PowerShell sessions.

Next Steps

For more information about using Azure PowerShell, see the Get started with Azure PowerShell article.