Installing Azure PowerShell from the PowerShell Gallery is the preferred method of installation.
Step 1: Install PowerShellGet
Installing items from the PowerShell Gallery requires the PowerShellGet module. Make sure you have the appropriate version of PowerShellGet and other system requirements. Run the following command to see if you have PowerShellGet installed on your system.
Get-Module PowerShellGet -list | Select-Object Name,Version,Path
You should see something similar to the following output:
Name Version Path ---- ------- ---- PowerShellGet 18.104.22.168 C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\22.214.171.124\PowerShellGet.psd1
If you do not have PowerShellGet installed, see the How to get PowerShellGet section of this article.
Using PowerShellGet requires an Execution Policy that allows you to run scripts. For more information about PowerShell's Execution Policy, see About Execution Policies.
Step 2: Install Azure PowerShell
Installing Azure PowerShell from the PowerShell Gallery requires elevated privileges. Run the following command from an elevated PowerShell session:
# Install the Azure Resource Manager modules from the PowerShell Gallery Install-Module AzureRM
If you have a version older than 126.96.36.199 of NuGet, you will be prompted to download and install the latest version of NuGet.
The AzureRM module is a rollup module for the Azure Resource Manager cmdlets. When you install the AzureRM module, any Azure Resource Manager module that has not previously been installed will be downloaded and installed from the PowerShell Gallery.
Once the module is installed, you need to load the module into your PowerShell session. Modules are
loaded using the
Import-Module cmdlet, as follows:
For more information about using Azure PowerShell, see the following articles:
Frequently asked questions
How to get PowerShellGet
|OS Version||Install instructions|
|I have Windows 10 or Windows Server 2016||Built into Windows Management Framework (WMF) 5.0 included in the OS|
|I want to upgrade to PowerShell 5||Install the latest version of WMF|
|I am running on a version of Windows with PowerShell 3 or PowerShell 4||Get the PackageManagement modules|
Checking the version of Azure PowerShell
Although we encourage you to upgrade to the latest version as early as possible, several versions of Azure PowerShell are support. To determine the version of Azure PowerShell you have installed, run
Get-Module AzureRM from your command line.
Get-Module AzureRM -list | Select-Object Name,Version,Path
Updating to a new version of Azure PowerShell
PowerShellGet has the ability to update an installed module when a new version has been released to
the PowerShell Gallery. Using the
Update-Module cmdlet, you can download and install the latest
version. The new version will be installed side-by-side with any other versions that
have been installed. The
Update-Module cmdlet does not remove previous versions.
If you want to reinstall the current version, you must use the
-Force parameter. For example:
Update-Module -Name AzureRM -Force
If you have deployments that use the classic deployment model that cannot be converted you can install the Service Management version of Azure PowerShell. For more information, see Install the Azure PowerShell Service Management module. The Azure and AzureRM modules share common dependencies. So if you use both modules you should update both.
Installing module versions side-by-side
The PowerShellGet method of installation is the only method that supports the installation of multiple versions. For example, you may have scripts written using a previous version of Azure PowerShell that you don't have the time or resources to updated. The following commands illustrate how to install multiple versions of Azure PowerShell:
Install-Module -Name AzureRM -RequiredVersion 3.7.0 Install-Module -Name AzureRM -RequiredVersion 1.2.9
Only one version of the module can be loaded in a PowerShell session. You must open a new
PowerShell window and use
Import-Module to import a specific version of the AzureRM cmdlets:
Import-Module AzureRM -RequiredVersion 1.2.9
Version 2.1.0 and version 1.2.6 are the first module versions designed to be installed and used side-by-side. When loading an earlier version of the Azure PowerShell modules using a command like the one above, incompatible versions of the AzureRM.Profile module will be loaded, resulting in the cmdlets asking you to log in whenever you execute a cmdlet, even after you have logged in.
Other installation methods
For information about installing using the Web Platform Installer or the MSI Package, see Other installation methods