Install and configure Azure PowerShell

• 03/27/2018
• 4 minutes to read
• Contributors
  • 
  • 

This article explains the steps to install the Azure PowerShell modules in a Windows environment. If you want to use Azure PowerShell on macOS or Linux, see the following article: Install and configure Azure PowerShell on macOS and Linux.

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 -Name PowerShellGet -ListAvailable | Select-Object -Property Name,Version,Path

You should see something similar to the following output:

Name          Version Path
----          ------- ----
Name          Version Path
----          ------- ----
PowerShellGet 1.6.0   C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\1.6.0\PowerShellGet.psd1
PowerShellGet 1.0.0.1 C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\1.0.0.1\PowerShellGet.psd1

You need PowerShellGet version 1.1.2.0 or higher. To update PowerShellGet, use the following command:

Install-Module PowerShellGet -Force

If you do not have PowerShellGet installed, see the How to get PowerShellGet section of this article.

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 -Name AzureRM -AllowClobber

By default, the PowerShell gallery is not 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"): Y

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

The AzureRM module is a rollup module for the Azure Resource Manager cmdlets. When you install the AzureRM module, any Azure PowerShell module not previously installed is downloaded and from the PowerShell Gallery.

If you have a previous version of Azure PowerShell installed you may receive an error. To resolve this issue, see the Updating to a new version of Azure PowerShell section of this article.

Step 3: Load the AzureRM module

Once the module is installed, you need to load the module into your PowerShell session. You should do this in a normal (non-elevated) PowerShell session. Modules are loaded using the Import-Module cmdlet, as follows:

Import-Module -Name AzureRM

Next Steps

For more information about using Azure PowerShell, see the following articles:

• Get started with Azure PowerShell

Reporting issues and feedback

If you encounter any bugs with the tool, file an issue in the Issues section of our GitHub repo. To provide feedback from the command line, use the Send-Feedback cmdlet.

Frequently asked questions

How to get PowerShellGet

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 supported. To determine the version of Azure PowerShell you have installed, run Get-Module AzureRM from your command line.

Get-Module AzureRM -ListAvailable | Select-Object -Property Name,Version,Path

Support for classic deployment methods

If you have deployments that use the classic deployment model 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. If you use both the Azure and AzureRM modules, you should install the same version of each package.

Updating to a new version of Azure PowerShell

If you have a previous version of Azure PowerShell installed that includes the Service Management module, you may receive the following error:

PackageManagement\Install-Package : A command with name 'Get-AzureStorageContainerAcl' is already
available on this system. This module 'Azure.Storage' may override the existing commands. If you
still want to install this module 'Azure.Storage', use -AllowClobber parameter.

At C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\1.0.0.1\PSModule.psm1:1772 char:21
+ ...          $null = PackageManagement\Install-Package @PSBoundParameters
+                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidOperation: (Microsoft.Power....InstallPackage:InstallPackage) [Install-Package], Exception
    + FullyQualifiedErrorId : CommandAlreadyAvailable,Validate-ModuleCommandAlreadyAvailable,Microsoft.PowerShell.PackageManagement.Cmdlets.InstallPackage

As the error message states, you need to use the -AllowClobber parameter to install the module. Use the following command:

# Install the Azure Resource Manager modules from the PowerShell Gallery
Install-Module -Name AzureRM -AllowClobber

For more information, see the help topic for Install-Module.

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 -Name AzureRM -RequiredVersion 1.2.9

Other installation methods

For information about installing using the Web Platform Installer or the MSI Package, see Other installation methods