Tip

For feedback, click here

The Windows Azure Active Directory team regularly updates the Azure Active Directory PowerShell Module with new features and functionality. Not all additions are applicable to all audiences.

This article is designed to help you keep track of the versions that have been released since calendar year 2014, and to understand whether you need to update to the newest version or not, while also providing you access to all previously released versions.

 

Back to top


Related FAQ

How can I determine what version of AAD PowerShell I have?

You can run the get-item cmdlet to check the version of the DLL files of the module that you have currently installed: (get-item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion

Where can I find the latest version of AAD PowerShell?

Installing PowerShell V2 from the PowerShell Gallery

The AzureAD PowerShell V2 module can be downloaded and installed from the PowerShell Gallery, www.powershellgallery.com.  The gallery uses the PowerShellGet module.

The PowerShellGet module requires PowerShell 3.0 or newer.

Therefore, PowerShellGet requires one of the following operating systems:

  • Windows 10
  • Windows 8.1 Pro
  • Windows 8.1 Enterprise
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 SP1

PowerShellGet also requires .NET Framework 4.5 or above. You can install .NET Framework 4.5 or above from here

For more information, please refer to https://msdn.microsoft.com/powershell/gallery/readme

What can I do if AAD PowerShell doesn’t work as expected after upgrading to the latest version?

Please use the download links below to reinstall a previous version of the AAD PowerShell Module to unblock any issues you may be facing, and then make a post to the Azure Active Directory Forum, describing your issue, and how to reproduce the problems.

Back to top


Release overview

 

Version 2.0.0.17 (PowerShell V2 Public Preview)

This is a public preview release of the new AzureAD PowerShell V2 cmdlets. The following changes are included in this release:

  • New cmdlets New-AzureADMSGroup, Set-AzureADMSGroup and Remove-AzureADMSGroup added. These cmdlets can be used to manage Office 365 groups and dynamic groups in your directory
  • New cmdlets to revoke a user’s Refresh Tokens added: Revoke-AzureADSignedInUserAllRefreshTokens and Revoke-AzureADUserAllRefreshTokens
  • Connect-AzureAD no longer requires -Force
  • Naming convention change for cmdlets that call Microsoft Graph
  • Going forward, all cmdlets that call Microsoft Graph will have “MS” in their cmdlet names, as in “Get-AzureADMSGroup”. The cmdlets that call Azure AD Graph will not change, so there is also a “Get-AzureADGroup” cmdlet.
Download link

64-bit



Version 2.0.0.7 (PowerShell V2 Public Preview)

This is a public preview release of the new AzureAD PowerShell V2 cmdlets. The following changes are included in this release:

  • New cmdlets to manage Policy objects have been added
  • New cmdlets to manage Device owner and user have been added
  • More inline help is a added
  • Domain cmdlet parameter is changed
  • Connect cmdlet parameter is changed
  • A Native app creation bug is fixed
  • A User creation/update bug fixed
  • There is improved reliability on link related cmdlets.
Download link

64-bit



Version 1.1.166.0 (PowerShell V1 General Availability)

This is the general availability release of the V1 version ("MSOnline") of Azure Active Directory PowerShell cmdlets. The following cmdlets have been added:

  • Get-MsolCompanyAllowedDataLocation
  • Set-MsolCompanyMultiNationalEnabled
  • Set-MsolCompanyAllowedDataLocation
The following cmdlets are not available in this release.
  • Get-MSOLAllSettings, Get-MSOLSetting, New-MSOLSetting, Remove-MSOLSetting, Set-MSOLSetting
  • Get-AllSettingTemplate, Get-SettingTemplate 
Please note that the Settings cmdlets that were published in the preview release of the MSOL module are no longer available in this module. This functionality can now be found in the newer Azure AD PowerShell V2 Preview module, which can be installed from here: https://www.powershellgallery.com/packages/AzureADPreview
More information about how to use the new cmdlets for Settings can be found here: https://docs.microsoft.com/en-us/azure/active-directory/active-directory-accessmanagement-groups-settings-cmdlets
More information about the Azure AD PowerShell V2 module can be found here: https://docs.microsoft.com/en-us/powershell/azuread/

Download link

64-bit

Version 1.1.143.0 (PowerShell V2 Public Preview)

This the public preview of the new V2 version of Azure Active Directory PowerShell cmdlets. This preview release marks a first step on a journey to renew the existing MSOL PowerShell cmdlets which you are so familiar with. One of the key features of this release is a close alignment of the PowerShell functionality with the Graph API capabilities. We are also moving towards a faster and more agile release process for new or updated functionality of these cmdlets.

The new PowerShell cmdlets provide more functionality in several areas, most notably for Modern Authentication and MFA, and includes management of Applications and Certificate Authority through PowerShell.

Over time, we will fully replace the existing MSOL cmdlets. You will see regular new functionality updates to this preview release until the complete replacement is available.

Some changes

As you will notice, some things have changed when compared to the existing MSOL library. First of all – we have updated the names of all cmdlets to conform with the Azure PowerShell naming conventions. Since we’re publishing a new module for these cmdlets, the name of the module has changed as well: the existing module’s name was “MSOL”, the new module is call “AzureAD”. So where e.g. an existing cmdlet was named “New-MSOLUser”, which adds a new user to the directory, the new cmdlet’s name is “New-AzureADUser.

Secondly – the parameters for the new cmdlets sometimes changed as well. As we are developing cmdlets in close alignment with the Graph API functionality, we’re also keeping the names of objects and parameters as close as possible to what is used in Graph API.

New functionality in AzureAD PowerShell

Managing Certificate Authority using Powershell for Azure AD

These are the new cmdlets that are used to manage Certificate Authority:

  • New-AzureADTrustedCertificateAuthority - Adds a new certificate authority for the tenant
  • Get-AzureADTrustedCertificateAuthorities - Retrieves the list of certificate authority for the tenant
  • Remove-AzureADTrustedCertificateAuthority - Removes a certificate authority for the tenant
  • Set-AzureADTrustedCertificateAuthority - Modifying a certificate authority for the tenant

Managing Applications in Azure AD using PowerShell

Several new cmdlets have been added to enable management of Applications in Azure AD using PowerShell. There is a set of cmdlets to create, modify and remove Applications:

  • New-AzureADApplication
  • Remove-AzureADApplication
  • Set-AzureADApplication
  • We also offer capabilities to manage Directory Extensions in PowerShell:
  • Get-AzureADApplicationExtensionProperty
  • New-AzureADApplicationExtensionProperty
  • Remove-AzureADApplicationExtensionProperty

There are new cmdlets to manage Owners for an Application:

  • Add-AzureADApplicationOwner
  • Get-AzureADApplicationOwner
  • Remove-AzureADApplicationOwner

And finally, we’re offering new capabilities to manage credentials for Applications in PowerShell:

  • Get-AzureADApplicationKeyCredential
  • New-AzureADApplicationKeyCredential
  • Remove-AzureADApplicationKeyCredential
  • Get-AzureADApplicationPasswordCredential
  • New-AzureADApplicationPasswordCredential
  • Remove-AzureADApplicationPasswordCredential

Download link

PowerShell Gallery


Back to top


Version 9031.1        

Released 3/10/2016
New Features
  • Added new cmdlets for DirSync Features
    • Get-MsolDirSyncFeatures
    • Set-MsolDirSyncFeature
  • Known Issue: Requires .NET 4.0

Download Link (EN)

32-Bit

64-Bit

 

Back to top


Version 8362.1

Released 1/19/2015
New Features
  • Added new Domain Federation Settings for MFA Scenarios
Download Link (EN)

 32-Bit

64-Bit

 

Back to top


Version 8262.2

Released 12/15/2014
New Features
  • Added new cmdlets for Administrative Units
  • Information about AUs can be found here
Download Link (EN)

 32-Bit

64-Bit

 

Back to top


Version 8073.4        

Released 11/5/2014
New Features
  • Fixed an issue where the wrong BecVersion number was being sent from PowerShell
  • Fixed issues with publishing a 32-bit build
Download Link (EN)

 32-Bit

64-Bit

 

Back to top


Version 8000.119       

Released 09/10/2014
New Features
  • Added new cmdlets for Email Verified User Scenarios
  • Information about EVUs can be found here
Download Link (EN)

 32-Bit

 64-Bit

 

Back to top


Preview Versions of MSOL PowerShell

Version 8808.1 (Public Preview v2)

Released 10/30/2015
New Features
  • Added additional Device Registration Service Management CMDLETs
    • Get-MsolDeviceRegistrationServicePolicy
    • Set-MsolDeviceRegistrationServicePolicy
Download Link (EN)

 32-Bit

64-Bit

 

Back to top


Version 8806.11 (Public Preview v1)

Released 9/25/2015
New Features
  • Removed dependency on MSOL Sign In Assistant
  • Added Modern Authentication with ADAL
  • Added Device Management CMDLETs

See blogpost here.

Download Link (EN)

 32-Bit

64-Bit

 

Back to top