MC806103 - Microsoft SharePoint: “Remove-SPOExternalUser” retires starting July 29, 2024

Message Center

This announcement expired on Sep 27, 2024 and is no longer active in Message Center.

Summary

The "Remove-SPOExternalUser" PowerShell cmdlet for SharePoint Online will retire on July 29, 2024. Users should transition to the "Remove-AzureADUser" cmdlet and update workflows to avoid disruption. Further details and guidance are available at Microsoft Learn.

Last Updated

Jul 5, 2024

Published Jun 27, 2024

View version history

Service

SharePoint Online

Tag

Major change
Updated message
Admin impact
Retirement

More information

Updated July 5, 2024: We have updated the content below with additional information. Thank you for your patience.

Starting July 29, 2024, and ending August 9, 2024, we will be retiring the Remove-SPOExternalUser PowerShell cmdlet for Microsoft SharePoint Online (SPO) users as part of our ongoing efforts to enhance security and streamline scope and permissions for external users.

After the retirement, requests using the Remove-SPOExternalUser cmdlet will be blocked with an error message similar to:

“To streamline scope and permissions for external users, enhance access management, and strengthen our security posture, this cmdlet has been deprecated. Alternatively, please use the Remove-MgUser cmdlet in Microsoft Graph PowerShell for user management. Learn more: Remove-MgUser (Microsoft.Graph.Users) | Microsoft Learn."

How this will affect your organization:

Our telemetry indicates that only a few organizations are active users of the Remove-SPOExternalUser cmdlet for their user management needs. If this change impacts your org, please note that the functionality will continue to be available through alternate means for the tenant admins/users (see below for details).

What you need to do to prepare:

Please begin immediately transitioning from using the Remove-SPOExternalUser cmdlet. To avoid unexpected impact, also ensure none of your workflows are calling this cmdlet. Instead, please use the Remove-MgUser cmdlet as described in Remove-MgUser (Microsoft.Graph.Users) | Microsoft Learn, where we will continue to invest resources. 

Additional Information:

Version history

2 versions tracked

Updated 1 time since Jun 27, 2024. Microsoft Message Center only ever shows the current version; this archive preserves the history.

Compare any two versions

From
To
  1. Jul 5, 2024 · 05:53 PMLatest · v2

    Changed: Body, Tags

  2. Jun 27, 2024 · 11:58 PMOriginal · v1

    Changed: Initial version