Install the Azure PowerShell module
This article tells you how to install the Azure PowerShell modules using PowerShellGet. These instructions work on Windows, macOS, and Linux platforms. For the Az module, currently no other installation methods are supported.
Azure PowerShell works with PowerShell 5.x on Windows 7 or higher, or PowerShell 6.x on any platform. To check your PowerShell version, run the command:
If you have an outdated version or need to install PowerShell, see Installing various versions of PowerShell. Install information for your platform is linked from that page.
If you are using PowerShell 5.x on Windows, you also need .NET Framework 4.7.2 installed. For instructions on updating or installing a new version of .NET Framework, see the .NET Framework installation guide.
Install the Azure PowerShell module
You can have both the AzureRM and Az modules installed at the same time. If you have both modules installed, don't enable aliases. Enabling aliases will cause conflicts between AzureRM cmdlets and Az command aliases, and could cause unexpected behavior. It's recommended that before installing the Az module, you uninstall AzureRM. You can always uninstall AzureRM or enable aliases at any time. To learn about the AzureRM command aliases, see Migrate from AzureRM to Az. For uninstall instructions, see Uninstall the AzureRM module.
To install modules at a global scope, you need elevated privileges to install modules from the PowerShell Gallery. To install Azure PowerShell, run the following command in an elevated session ("Run as Administrator" on Windows, or with superuser privileges on macOS or Linux):
Install-Module -Name Az -AllowClobber
If you don't have access to administrator privileges, you can install for the current user by adding the
Install-Module -Name Az -AllowClobber -Scope CurrentUser
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"):
Yes to All to continue with the installation.
The Az module is a rollup module for the Azure PowerShell cmdlets. Installing it downloads all of the available Azure Resource Manager modules, and makes their cmdlets available for use.
To start working with Azure PowerShell, sign in with your Azure credentials.
# Connect to Azure with a browser sign in token Connect-AzAccount
If you've disabled module autoloading, you need to manually import the module with
Import-Module Az. Because of
the way the module is structured, this can take a few seconds.
You'll need to repeat these steps for every new PowerShell session you start. To learn how to persist your Azure sign-in across PowerShell sessions, see Persist user credentials across PowerShell sessions.
Update the Azure PowerShell module
You can update your Azure PowerShell installation by running Update-Module. This command does not uninstall older versions.
Update-Module -Name Az
To learn how to remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module.
Use multiple versions of Azure PowerShell
It's possible to install more than one version of Azure PowerShell. To check if you have multiple versions of Azure PowerShell installed, use the following command:
Get-InstalledModule -Name Az -AllVersions | select Name,Version
To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.
You can install or load a specific version of the
Az module by using the
# Install Az version 0.7.0 Install-Module -Name Az -RequiredVersion 0.7.0 # Load Az version 0.7.0 Import-Module -Name Az -RequiredVersion 0.7.0
If you have more than one version of the module installed, module autoload and
Import-Module load the
latest version by default.
To learn more about the Azure PowerShell modules and their features, see Get Started with Azure PowerShell. If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.