Microsoft 365


Active Directory


Windows Server


Chance to win $250 in Petri 2023 Audience Survey


365 Apps

Microsoft 365 Changelog


M365 Changelog: We’re updating the Hybrid federated search

Petri Staff


MC270671 – Updated August 31, 2021: Microsoft has updated the content below to provided additional clarity. Thank you for your patience.

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 search modernization in Microsoft 365 Microsoft is updating the infrastructure used by SharePoint Server’s Hybrid federated search. 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.

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:

  1. Register a new Service Principal for Federated Search Skill in SharePoint Online.
  2. Register a new Application Principal for Federated Search Skill in SharePoint On-Premises.
  3. 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:

  1. Please download the configuration script.
  2. 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]
  3. When prompted, login using Microsoft 365 Global Administrator account.
  4. Wait for script execution to finish, in case there are any issues, please contact Microsoft Support.
  5. After script execution, users will see no changes when this change is implemented.

Please click Additional Information to learn more.

Review: Plan hybrid federated search for SharePoint ServerAdditional information

Article saved!

Access saved content from your profile page. View Saved