Konfigurieren der Suche für Microsoft 365 Multi-Geo
Konfigurieren von Multi-Geo-Search
Ihr Multi-Geo-Mandant verfügt über Aggregatsuchfunktionen, die es einer Suchabfrage ermöglichen, Ergebnisse von überall innerhalb des Mandanten zurückzugeben.
Standardmäßig geben Suchvorgänge von diesen Einstiegspunkten aggregierte Ergebnisse zurück, obwohl sich jeder Suchindex an seinem relevanten geografischen Standort befindet:
- OneDrive
- Delve
- SharePoint-Homepage
- Suchcenter
Darüber hinaus können Multi-Geo-Suchfunktionen für Ihre benutzerdefinierten Suchanwendungen konfiguriert werden, die die SharePoint-Such-API verwenden.
Anweisungen einschließlich aller Einschränkungen und Unterschiede finden Sie unter Konfigurieren von Search für OneDrive Multi-Geo.
Überprüfen der Microsoft 365 Multi-Geo-Konfiguration
Im Folgenden finden Sie einige grundlegende Anwendungsfälle, in denen eine Überprüfung vor dem Rollout von Microsoft 365 Multi-Geo im Unternehmen möglicherweise sinnvoll ist. Nach Abschluss dieser Tests und zusätzlicher Anwendungsfälle, die für Ihr Unternehmen relevant sind, können Sie der ursprünglichen Pilotgruppe bei Bedarf weitere Benutzer hinzufügen.
OneDrive:
Wählen Sie Im Microsoft 365-App-Startfeld OneDrive aus, und vergewissern Sie sich, dass Sie basierend auf der PDL des Benutzers automatisch zum entsprechenden Geografischen Standort für den Benutzer weitergeleitet werden. OneDrive sollte jetzt mit der Bereitstellung an diesem Standort beginnen. Versuchen Sie nach der Bereitstellung, einige Dokumente hoch- und herunterzuladen.
OneDrive Mobile App:
Melden Sie sich mit den Anmeldeinformationen Ihres Testkontos bei Ihrer mobilen OneDrive-App an. Vergewissern Sie sich, dass Sie Ihre OneDrive-Dateien anzeigen und von Ihrem mobilen Gerät aus mit ihnen interagieren können.
OneDrive-Synchronisation Client:
Vergewissern Sie sich, dass der OneDrive-Synchronisation-Client Ihren OneDrive Geography-Standort bei der Anmeldung automatisch erkennt. Wenn Sie den Synchronisierungsclient herunterladen müssen, können Sie in der OneDrive-Bibliothek auf Synchronisieren klicken.
Office-Anwendungen:
Vergewissern Sie sich, dass Sie auf OneDrive zugreifen können, indem Sie sich über eine Office-Anwendung anmelden, z. B. Word. Öffnen Sie die Office-Anwendung, und wählen Sie OneDrive – <TenantName> aus. Office erkennt Ihren OneDrive-Speicherort und zeigt Ihnen die Dateien an, die Sie öffnen können.
Teilens:
Versuchen Sie, OneDrive-Dateien frei zu geben. Vergewissern Sie sich, dass die Personenauswahl Ihnen alle Ihre SharePoint-Benutzer unabhängig von ihrem geografischen Standort anzeigt.
In einer Multi-Geo-Umgebung verfügt jeder Geography-Standort über einen eigenen Suchindex und Search Center. Wenn ein Benutzer eine Suche durchführt, wird die Abfrage in alle Indizes aufgefächert, und die zurückgegebenen Ergebnisse werden zusammengeführt.
Beispielsweise kann ein Benutzer an einem Geografischen Standort nach Inhalten suchen, die an einem anderen Geografischen Speicherort gespeichert sind, oder nach Inhalten auf einer SharePoint-Website, die auf einen anderen Geografischen Standort beschränkt ist. Wenn der Benutzer Zugriff auf diese Inhalte hat, liefert die Suche das Ergebnis.
Welche Suchclients funktionieren in einer Multi-Geo-Umgebung?
Diese Clients können Ergebnisse von allen Geografischen Standorten zurückgeben:
- OneDrive
- Delve
- Die SharePoint-Homepage
- Das Suchcenter
- Benutzerdefinierte Suchanwendungen, die die SharePoint-Suche-API verwenden
OneDrive
Sobald die Multi-Geo-Umgebung eingerichtet wurde, erhalten Benutzer, die in OneDrive suchen, Ergebnisse von allen Geografischen Standorten.
Delve
Sobald die Multi-Geo-Umgebung eingerichtet wurde, erhalten Benutzer, die in Delve suchen, Ergebnisse von allen Geografischen Standorten.
Der Delve-Feed und die Profilkarte zeigen nur eine Vorschau der Dateien an, die an dem zentralen Standort gespeichert sind. Für Dateien, die an Satellitengeografiespeicherorten gespeichert sind, wird stattdessen das Symbol für den Dateityp angezeigt.
Die SharePoint-Homepage
Sobald die Multi-Geo-Umgebung eingerichtet wurde, sehen Benutzer Nachrichten, aktuelle und gefolgte Websites von mehreren Geografischen Standorten auf ihrer SharePoint-Startseite. Wenn sie das Suchfeld auf der SharePoint-Startseite verwenden, erhalten sie zusammengeführte Ergebnisse von mehreren Geografischen Standorten.
Das Suchcenter
Nachdem die Multi-Geo-Umgebung eingerichtet wurde, zeigt jedes Search Center weiterhin nur Ergebnisse von ihrem eigenen geografischen Standort an. Administratoren müssen die Einstellungen der einzelnen Search Center ändern, um Ergebnisse von allen Geografischen Standorten zu erhalten. Anschließend erhalten Benutzer, die im Search Center suchen, Ergebnisse von allen Geografischen Standorten.
Benutzerdefinierte Suchanwendungen
Wie üblich interagieren benutzerdefinierte Suchanwendungen mithilfe der vorhandenen SharePoint-Search REST-APIs mit den Suchindizes. Um Ergebnisse von allen oder einigen Geografiestandorten zu erhalten, muss die Anwendung die API aufrufen und die neuen Multi-Geo-Abfrageparameter in die Anforderung einschließen. Dadurch wird ein Auffächern der Abfrage an alle Geografischen Standorte ausgelöst.
Was ist anders bei der Suche in einer Multi-Geo-Umgebung?
Einige Suchfunktionen, die Sie möglicherweise bereits kennen, funktionieren in einer Multi-Geo-Umgebung anders.
| Feature | So funktioniert es | Problemumgehung |
|---|---|---|
| Höhergestufte Ergebnisse | Sie können Abfrageregeln mit höher gestuften Ergebnissen auf verschiedenen Ebenen erstellen: für den gesamten _Tenant_, für eine Websitesammlung oder für eine Website. Definieren Sie in einer Multi-Geo-Umgebung höher gestufte Ergebnisse auf _Tenant_-Ebene, um die Ergebnisse auf die Search Center an allen _Geography_-Standorten heraufzustufen. Wenn Sie ergebnisse nur im Search Center höher stufen möchten, das sich am Speicherort _Geography_ der Websitesammlung oder Website befindet, definieren Sie die höher gestuften Ergebnisse auf Websitesammlungs- oder Websiteebene. Diese Ergebnisse werden an anderen _Geography_-Speicherorten nicht höher gestuft. | Wenn Sie nicht unterschiedliche höher gestufte Ergebnisse pro _Geography_-Standort benötigen, z. B. unterschiedliche Regeln für Reisen, empfehlen wir, höher gestufte Ergebnisse auf der Ebene _Tenant_ zu definieren. |
| Sucheinschränkungen | Search gibt Einschränkungen von allen _Geography_-Speicherorten eines _Mandanten_ zurück und aggregiert sie dann. Die Aggregation ist eine optimale Leistung, was bedeutet, dass die Einschränkungsanzahl möglicherweise nicht zu 100 % genau ist. Für die meisten suchgesteuerten Szenarien ist diese Genauigkeit ausreichend. | Für suchgesteuerte Anwendungen, die von der Vollständigkeit der Einschränkung abhängen, fragen Sie jeden _Geography_-Speicherort unabhängig ab. |
| Die Multi-Geo-Suche unterstützt kein dynamisches Bucketing für numerische Einschränkungen. | Verwenden Sie den Parameter "Discretize" für numerische Einschränkungen. | |
| Dokument-IDs | Wenn Sie eine suchgesteuerte Anwendung entwickeln, die von Dokument-IDs abhängt, beachten Sie, dass Dokument-IDs in einer Multi-Geo-Umgebung nicht über _Geography_-Standorte hinweg eindeutig sind, sie sind pro _Geography_-Speicherort eindeutig. | Wir haben eine Spalte hinzugefügt, die den Standort _Geography_ angibt. Verwenden Sie diese Spalte, um Eindeutigkeit zu erreichen. Diese Spalte heißt "GeoLocationSource". |
| Anzahl der Ergebnisse | Auf der Suchergebnisseite werden kombinierte Ergebnisse aus den _Geography_-Speicherorten angezeigt, es ist jedoch nicht möglich, eine Seite von mehr als 500 Ergebnissen zu erstellen. | |
| Hybridsuche | In einer SharePoint-Hybridumgebung mit Cloudhybridsuche werden lokale Inhalte dem Microsoft 365-Index des zentralen Standorts hinzugefügt. |
Was wird bei der Suche in einer Multi-Geo-Umgebung nicht unterstützt?
Einige Suchfunktionen, die Sie möglicherweise bereits kennen, werden in einer Multi-Geo-Umgebung nicht unterstützt.
| Suchfunktion | Hinweis |
|---|---|
| Nur-App-Authentifizierung | Nur-App-Authentifizierung (privilegierter Zugriff von Diensten) wird bei der Multi-Geo-Suche nicht unterstützt. |
| Gäste | Gäste erhalten nur Ergebnisse aus dem _Geography_-Speicherort, von dem aus sie suchen. |
Wie funktioniert die Suche in einer Multi-Geo-Umgebung?
Alle Suchclients verwenden die vorhandenen SharePoint-Suche-REST-APIs für die Interaktion mit den Suchindizes.
- Ein Suchclient ruft den REST-Endpunkt für die Suche mit der Abfrageeigenschaft „EnableMultiGeoSearch= true“ auf.
- Die Abfrage wird an alle Geography-Standorte im Mandanten gesendet.
- Search Ergebnisse der einzelnen Geografischen Standorte werden zusammengeführt und bewertet.
- Der Client erhält einheitliche Suchergebnisse.
Beachten Sie, dass die Suchergebnisse erst dann zusammengeführt werden, wenn die Ergebnisse von allen geografischen Standorten abgerufen wurden. Dies bedeutet, dass Multi-Geo-Suchen im Vergleich zu den Suchen in einer Umgebung mit nur einem geografischen Standort eine zusätzliche Wartezeit aufweisen.
Anzeigen der Ergebnisse von allen geografischen Standorten in einem Suchcenter
Jedes Suchcenter verfügt über mehrere Suchsparten, und Sie müssen jede Sparte einzeln einrichten.
Stellen Sie sicher, dass Sie diese Schritte mit einem Konto ausführen, das über die Berechtigung zum Bearbeiten der Suchergebnisseite und des Suchergebnisse-Webparts verfügt.
Navigieren Sie zur Seite mit den Suchergebnissen (siehe Liste der Suchergebnisseiten).
Wählen Sie die Vertikale aus, die eingerichtet werden soll, klicken Sie in der oberen rechten Ecke auf Zahnradsymbol Einstellungen , und klicken Sie dann auf Seite bearbeiten. Die Seite wird im Bearbeitungsmodus angezeigt.
Bewegen Sie im Suchergebnisse-Webpart den Mauszeiger in die obere rechte Ecke des Webparts, klicken Sie auf den Pfeil, und klicken Sie dann im Menü auf Webpart bearbeiten. Der Toolbereich für das Suchergebnisse-Webpart wird unter dem Menüband oben rechts auf der Seite geöffnet.
Wählen Sie im Webpart-Toolbereich im Abschnitt Einstellungen unter Einstellungen für das Ergebnissteuerelement die Option Multi-Geo-Ergebnisse anzeigen, damit das Suchergebnisse-Webpart Ergebnisse von allen geografischen Standorten anzeigt.
Klicken Sie auf OK, um Ihre Änderungen zu speichern und den Webpart-Toolbereich zu schließen.
Überprüfen Sie Ihre Änderungen an dem Suchergebnisse-Webpart, indem Sie im Hauptmenü auf der Registerkarte „Seite“ auf Einchecken klicken.
Veröffentlichen Sie die Änderungen über den Link in der Notiz oben auf der Seite.
Anzeigen von Ergebnissen von allen oder einigen geografischen Standorten in benutzerdefinierten Suchanwendungen
Benutzerdefinierte Suchanwendungen erhalten Ergebnisse von allen oder einigen Geography-Speicherorten, indem sie Abfrageparameter mit der Anforderung an die SharePoint-Search REST-API angeben. Abhängig von den Abfrageparametern wird die Abfrage auf alle geografischen Standorte oder auf einige geografische Standorte aufgefächert. Wenn Sie z. B. nur eine Teilmenge der Geografischen Standorte abfragen müssen, um relevante Informationen zu finden, können Sie den Auffächer nur auf diese festlegen. Wenn die Anforderung erfolgreich ist, gibt die SharePoint-Search-REST-API Antwortdaten zurück.
Anforderung
Für jeden geografischen Standort müssen Sie sicherstellen, dass allen Benutzern im organization die Berechtigungsstufe Lesen für die Stammwebsite gewährt wurde (z. B. contosoAPAC.sharepoint.com/ und contosoEU.sharepoint.com/). Erfahren Sie mehr über Berechtigungen.
Abfrageparameter
EnableMultiGeoSearch: Dies ist ein boolescher Wert, der angibt, ob die Abfrage an die Indizes anderer geografischer Standorte des Multi-Geo-Mandanten aufgefächert werden soll. Legen Sie ihn auf true fest, um die Abfrage aufzufächern, oder auf false, wenn die Abfrage nicht aufgefächert werden soll. Wenn Sie diesen Parameter nicht angeben, lautet der Standardwert false, außer wenn Sie einen Rest API-Aufruf für eine Website durchführen, die die Vorlage "Enterprise-Suchcenter" verwendet. In diesem Fall lautet der Standardwert true. Wenn Sie den Parameter in einer Nicht-Multi-Geo-Umgebung verwenden, wird der Parameter ignoriert.
ClientType – Dies ist eine Zeichenfolge. Geben Sie einen eindeutigen Clientnamen für jede Suchanwendung ein. Wenn Sie diesen Parameter nicht angeben, wird die Abfrage nicht in andere geografische Standorte aufgefächert.
MultiGeoSearchConfiguration: Dies ist eine optionale Liste der geografischen Standorte im Multi-Geo-Mandanten, an die die Abfrage gefächert werden soll, wenn EnableMultiGeoSearchtrue ist. Wenn Sie diesen Parameter nicht angeben oder leer lassen, wird die Abfrage für alle geografischen Speicherorte aufgefächert. Geben Sie für jeden geografischen Standort die folgenden Elemente im JSON-Format an:
| Element | Beschreibung |
|---|---|
| DataLocation | Der Standort _Geography_, z. B. NAM. |
| EndPoint | Der Endpunkt für die Verbindung, zum Beispiel https://contoso.sharepoint.com |
| SourceId | Die GUID der Ergebnisquelle, zum Beispiel B81EAB55-3140-4312-B0F4-9459D1B4FFE. |
Wenn Sie DataLocation oder EndPoint weglassen oder ein DataLocation-Wert dupliziert wird, schlägt die Anforderung fehl. Mithilfe von Microsoft Graph können Sie Informationen zum Endpunkt der geografischen Standorte eines Mandanten abrufen.
Antwortdaten
MultiGeoSearchStatus: Dies ist eine Eigenschaft, die die SharePoint-Search-API als Antwort auf eine Anforderung zurückgibt. Der Wert der -Eigenschaft ist eine Zeichenfolge und gibt die folgenden Informationen zu den Ergebnissen an, die die SharePoint-Search-API zurückgibt:
| Wert | Beschreibung |
|---|---|
| Vollständig | Vollständige Ergebnisse von allen _Geography_-Speicherorten. |
| Teilweise | Teilergebnisse von einem oder mehreren _Geography_-Speicherorten. Die Ergebnisse sind aufgrund eines vorübergehenden Fehlers unvollständig. |
Abfrage mithilfe des REST-Diensts
Für eine GET-Anforderung geben Sie die Abfrageparameter in der URL an. Bei einer POST-Anforderung übergeben Sie die Abfrageparameter im Textkörper im JSON-Format (JavaScript Object Notation).
Anforderungsheader
| Name | Wert |
|---|---|
| Content-Type | application/json;odata=verbose |
Beispiel für eine GET-Anforderung, die für alle geografischen Standorte aufgefächert wird
https:// \<tenant\>/\_api/search/query?querytext='sharepoint'&Properties='EnableMultiGeoSearch:true'&ClientType='my\_client\_id'
Beispiel für eine GET-Anforderung, die für einige geografischen Standorte aufgefächert wird
https:// \<tenant\>/\_api/search/query?querytext='site'&ClientType='my_client_id'&Properties='EnableMultiGeoSearch:true, MultiGeoSearchConfiguration:[{DataLocation\\:"NAM"\\,Endpoint\\:"https\\://contosoNAM.sharepoint.com"\\,SourceId\\:"B81EAB55-3140-4312-B0F4-9459D1B4FFEE"}\\,{DataLocation\\:"CAN"\\,Endpoint\\:"https\\://contosoCAN.sharepoint-df.com"}]'
Hinweis
Kommas und Doppelpunkten in der Liste der geografischen Standorte für die Eigenschaft MultiGeoSearchConfiguration wird ein umgekehrtes Schrägstrichzeichen vorangestellt. Dies hat den Grund, dass in GET-Anforderungen Doppelpunkte zum Trennen von Eigenschaften und Kommas zum Trennen von Argumenten von Eigenschaften verwendet werden. Ohne den umgekehrten Schrägstrich als Escapezeichen würde die MultiGeoSearchConfiguration-Eigenschaft falsch interpretiert.
Beispiel für eine POST-Anforderung, die für alle geografischen Standorte aufgefächert wird
{
"request": {
"__metadata": {
"type": "Microsoft.Office.Server.Search.REST.SearchRequest"
},
"Querytext": "sharepoint",
"Properties": {
"results": [
{
"Name": "EnableMultiGeoSearch",
"Value": {
"QueryPropertyValueTypeIndex": 3,
"BoolVal": true
}
}
]
},
"ClientType": "my_client_id"
}
}
Beispiel für eine POST-Anforderung, die für einige geografische Standorte aufgefächert wird
{
"request": {
"Querytext": "SharePoint",
"ClientType": "my_client_id",
"Properties": {
"results": [
{
"Name": "EnableMultiGeoSearch",
"Value": {
"QueryPropertyValueTypeIndex": 3,
"BoolVal": true
}
},
{
"Name": "MultiGeoSearchConfiguration",
"Value": {
"StrVal": "[{\"DataLocation\":\"NAM\",\"Endpoint\":\"https://contoso.sharepoint.com\",\"SourceId\":\"B81EAB55-3140-4312-B0F4-9459D1B4FFEE\"},{\"DataLocation\":\"CAN\",\"Endpoint\":\"https://contosoCAN.sharepoint.com\"}]",
"QueryPropertyValueTypeIndex": 1
}
}
]
}
}
}
Abfrage mithilfe von CSOM
Hier sehen Sie eine CSOM-Beispielabfrage, die an alleGeografischen Standorte aufgefächert wird:
var keywordQuery = new KeywordQuery(ctx);
keywordQuery.QueryText = query.SearchQueryText;
keywordQuery.ClientType = <enter a string here>;
keywordQuery.Properties["EnableMultiGeoSearch"] = true;
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für