Important update: Deprecation of Azure AD PowerShell and MSOnline PowerShell modules

In 2021, we described our plans to invest in Microsoft Graph PowerShell SDK as the PowerShell provider for Microsoft Entra and transition away from Azure AD and MSOnline PowerShell modules. In 2023, we announced that the deprecation of Azure AD and MSOnline PowerShell modules would occur on March 30, 2024. We’ve since made substantial progress closing remaining parity gaps in Microsoft Graph PowerShell SDK, and as of March 30, 2024, these PowerShell modules are now deprecated:

• Azure AD PowerShell (AzureAD) 
• Azure AD PowerShell Preview (AzureADPreview) 
• MS Online (MSOnline) 

You should migrate your scripts to Microsoft Graph PowerShell SDK as soon as possible. Information about the retirement of these modules can be found below.

What happens to MSOnline and Azure AD Modules after March 30, 2024?

As of March 30, 2024, Azure AD, Azure AD Preview, and MS Online PowerShell modules are deprecated. Support will only be offered for critical security fixes. They will continue to function through March 30, 2025. Note: Only MSOnline versions 1.1.166.0 (2017) and later are assured to function through March 30, 2025. Use of versions earlier than 1.1.166.0 may experience disruptions after June 30, 2024.

Required Actions

1. Identify scripts in your environment that are using Azure AD or MS Online PowerShell modules. 
2. Take immediate action to migrate scripts that are using MS Online versions below 1.1.166.0. If you’re not ready to migrate to Microsoft Graph PowerShell, you can update to the latest version of MSOnline PowerShell (1.1.183.81) to avoid impact after June 30, 2024. To inspect the version of MS Online module, you can use this PowerShell command: > Get-InstalledModule MSOnline 
3. Plan to migrate all MS Online (latest version) and Azure AD PowerShell scripts to Microsoft Graph by March 30, 2025.
4. Migrate these scripts to use Microsoft Graph PowerShell SDK.
    

We’re making substantial new and future investments in the PowerShell experience for managing Entra. Please continue to monitor this space as we announce exciting improvements in the coming months.

About Microsoft Graph PowerShell SDK

The Microsoft Graph PowerShell SDK provides cmdlets for the entire API surface of Microsoft Graph, including Microsoft Entra ID. It features cross-platform and PowerShell 7 support, offers modern authentication, and is regularly updated. 
 

Resources 

• Microsoft Graph PowerShell SDK overview 
• Migrate from Azure AD PowerShell to Microsoft Graph PowerShell 
• Azure AD PowerShell to Microsoft Graph PowerShell migration FAQ  –  
• Find Azure AD and MSOnline cmdlets in Microsoft Graph PowerShell  
• Microsoft Graph Compatibility Adapter  

Kristopher Bash 
Product Manager, Microsoft Graph 
LinkedIn

Learn more about Microsoft Entra: 

• See recent Microsoft Entra blogs 
• Dive into Microsoft Entra technical documentation 
• Learn more at Azure Active Directory (Azure AD) rename to Microsoft Entra ID 
• Join the conversation on the Microsoft Entra discussion space 
• Learn more about Microsoft Security