What is the parameter for Update-FederatedHybridSearchForM365.ps1 script?

SP 2022 121 Reputation points
2021-09-15T15:25:27.07+00:00

Hi,

There is a notification from Microsoft (in the Microsoft 365 admin center) about the Hybrid search update which says if we use hybrid search we must execute the Update-FederatedHybridSearchForM365.ps1 script before October 1st, 2021 otherwise your hybrid will stop working. The script can be downloaded from here.

Script execution parameter format:

Update-FederatedHybridSearchForM365.ps1 -HybridWebApp [YourHybridWebApplication] [-Force]

Description about the -HybridWebApp parameter

The internal URL of your on-premises primary web application, such as http://sharepoint or https://sharepoint.adventureworks.com. This value is a full URL using the proper protocol (either http: // or https:// ). This is the internal URL of the web application that you are using for hybrid functionality. An example is http://sharepoint or https://sharepoint.adventureworks.com.

My question is - in our SharePoint on-premise environment, inside the cloud search content source we have configured five web applications for the hybrid search functionality, then out of these five web applications, how to justify which is the primary web application or should we execute this script for all the five web applications or only in one web application?

Anyone could please share your experience with this if you have already executed or know about it.

Thanks,
Habibur Rahaman

SharePoint Server Management
SharePoint Server Management
SharePoint Server: A family of Microsoft on-premises document management and storage systems.Management: The act or process of organizing, handling, directing or controlling something.
2,517 questions
0 comments No comments
{count} votes

Accepted answer
  1. Emily Du-MSFT 29,596 Reputation points Microsoft Vendor
    2021-09-23T09:24:55.043+00:00

    @HabiburRahaman-3261

    According to your comment in this post, Microsoft support team said that this script has to be executed in all web application mentioned in the hybrid search content source.

    Thanks you for correcting my misunderstanding and sharing your solution.


    If an Answer is helpful, please click "Accept Answer" and upvote it.
    Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

    0 comments No comments

1 additional answer

Sort by: Most helpful
  1. Emily Du-MSFT 29,596 Reputation points Microsoft Vendor
    2021-09-16T08:21:46.46+00:00

    @HabiburRahaman-3261

    Per my knowledge, there are four following main reasons to execute 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.
    4.Register EVO/eSTS as a Trusted Token Issuer at SharePoint On-Premises.

    You should execute the script for only one web application to register new principals.


    If an Answer is helpful, please click "Accept Answer" and upvote it.
    Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

    1 person found this answer helpful.