MC270671: Microsoft is updating the Hybrid federated search

Microsoft has making some changes to the Hybrid federated search, also called inbound hybrid search, where user searches from the SharePoint in Microsoft 365 Search Center display hybrid results. As part of the process, customers who are using the Hybrid federated search with hybrid SharePoint deployments will need to update their configuration to continue using hybrid search with SharePoint Server and SharePoint Online. If you are not actively using or have implemented the Hybrid federated search with on-premises SharePoint, you can safely ignore this communication.

MC270671: We're updating the Hybrid federated search

Affected Workloads

  • Microsoft 365 suite
  • SharePoint Online

Key points

  • Timing: By October 1, 2021 customers using the Hybrid federated search with SharePoint Server will need to update their configuration to continue using hybrid search features with SharePoint Online.
  • Roll-out: tenant level
  • Control type: admin control
  • Action: review, assess, and apply configuration change by October 1, 2021

How this will affect your organization

The necessary configuration is provided as a Windows PowerShell script that is used to adjust an existing SharePoint Hybrid configuration to successfully work and authenticate using the new Microsoft 365 search engine.

There are three main procedures executed as part of the script:

  • Register a new Service Principal for Federated Search Skill in SharePoint Online.
  • Register a new Application Principal for Federated Search Skill in SharePoint On-Premises.
  • Grant appropriate permissions to SharePoint On-Premises Federated Search Skill Application Principal.

Note: In the event you have not updated your servers by October 1, 2021 as outlined, users will no longer receive on-premises SharePoint results in SharePoint Online. Applying the configuration change will not affect the user experience.

What you need to do to prepare

To apply the configuration change:

  • Please download the configuration script.
  • From the directory where the script was downloaded, execute the script using SharePoint On-Premises Farm Administrator account, using the following command: Update-FederatedHybridSearchForM365.ps1 -HybridWebApp [YourHybridWebApplication] [-Force]
  • For more information on the parameter values please run the following command: Get-Help .\Update-FederatedHybridSearchForM365.ps1
  • When prompted, login using Microsoft 365 Global Administrator account.
  • Wait for script execution to finish, in case there are any issues, please contact Microsoft Support.
  • After script execution, users will see no changes when this change is implemented.

Learn more

Message ID: MC270671
Published: 16 July 2021
Updated: 31 August 2021
Effective: October 1, 2021
Action required by date: 01 October 2021