SharePoint Suche und Suchkonfiguration SharePoint Search and Search Configuration

Referenz für Sucharchitektur, Search Schema, Result Sources, Query Rules, Modern Search, Graph Search und Troubleshooting. Reference for search architecture, search schema, result sources, query rules, modern search, Graph search, and troubleshooting.

Sucharchitektur und Content Sources Search architecture and content sources

In SharePoint Online wird der Suchindex als Dienst von Microsoft betrieben. Klassische Suchkonzepte wie Crawled Properties, Managed Properties und Result Sources bleiben relevant, aber viele on-premises Konzepte wie frei definierbare Crawl Schedules oder klassische Content Sources sind in der Cloud eingeschränkt. In SharePoint Online, the search index is operated by Microsoft as a service. Classic search concepts such as crawled properties, managed properties, and result sources remain relevant, but many on-premises concepts like freely defined crawl schedules or traditional content sources are limited in the cloud.

Für externe Datenquellen sind heute meist Graph Connectors und Microsoft Search die richtige Antwort. Administratoren sollten daher klar unterscheiden: SharePoint Search Schema für M365-Inhalte, Microsoft Search für übergreifende Experiences und Graph Connectors für externe Inhalte. For external data sources, Graph connectors and Microsoft Search are usually the right answer today. Administrators should clearly distinguish between SharePoint search schema for Microsoft 365 content, Microsoft Search for cross-suite experiences, and Graph connectors for external content.

Architekturbausteine Architecture building blocks

Implementierung Implementation

1. Bestandsaufnahme, Rollen und Abhängigkeiten für Sucharchitektur und Content Sources dokumentieren. Document the current state, roles, and dependencies for Search architecture and content sources.
2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

• Tenant-Limits, Lizenzzustand und Rollenzuweisungen beeinflussen Sucharchitektur und Content Sources direkt. Tenant limits, license state, and role assignments directly affect Search architecture and content sources.
• Automatisierung sollte Idempotenz, Logging und Fehlerklassifizierung enthalten. Automation should include idempotency, logging, and error classification.
• Änderungen sollten in Pilotwellen getestet und mit Nutzerkommunikation begleitet werden. Changes should be tested in pilot waves and accompanied by user communication.
• Für Audits lohnt sich eine dokumentierte Soll-Konfiguration mit regelmäßigem Drift-Abgleich. For audits, keep a documented target state and compare for drift regularly.

PowerShell: Suchkonfiguration exportieren PowerShell: export search configuration

Connect-PnPOnline -Url https://contoso.sharepoint.com/sites/search -Interactive
Get-PnPSearchConfiguration -Scope Site | Out-File .\search-site.xml
Submit-PnPSearchQuery -Query "contentclass:STS_Site" -All

Managed und Crawled Properties, Search Schema und Result Types Managed and crawled properties, search schema, and result types

Das Search Schema steuert, welche Metadaten durchsuchbar, sortierbar, verfeinerbar oder abrufbar sind. Gerade für Information Architecture, Content Types und PnP Modern Search ist es essenziell, Managed Properties sauber zu benennen und Doppelmappings zu vermeiden. The search schema controls which metadata is searchable, sortable, refinable, or retrievable. Especially for information architecture, content types, and PnP Modern Search, it is essential to name managed properties cleanly and avoid duplicate mappings.

Result Types stammen aus der klassischen Suchwelt, sind aber weiterhin nützlich, wenn unterschiedliche Inhaltstypen unterschiedliche Anzeigevorlagen oder priorisierte Actions erhalten sollen. In modernen Oberflächen werden diese Ideen oft durch Result Layouts und Verticals ergänzt oder ersetzt. Result types come from the classic search world but are still useful when different content types should receive different display templates or prioritized actions. In modern surfaces, these ideas are often supplemented or replaced by result layouts and verticals.

Eigenschaftsdesign Property design

Implementierung Implementation

1. Bestandsaufnahme, Rollen und Abhängigkeiten für Managed und Crawled Properties, Search Schema und Result Types dokumentieren. Document the current state, roles, and dependencies for Managed and crawled properties, search schema, and result types.
2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

• Tenant-Limits, Lizenzzustand und Rollenzuweisungen beeinflussen Managed und Crawled Properties, Search Schema und Result Types direkt. Tenant limits, license state, and role assignments directly affect Managed and crawled properties, search schema, and result types.
• Automatisierung sollte Idempotenz, Logging und Fehlerklassifizierung enthalten. Automation should include idempotency, logging, and error classification.
• Änderungen sollten in Pilotwellen getestet und mit Nutzerkommunikation begleitet werden. Changes should be tested in pilot waves and accompanied by user communication.
• Für Audits lohnt sich eine dokumentierte Soll-Konfiguration mit regelmäßigem Drift-Abgleich. For audits, keep a documented target state and compare for drift regularly.

KQL / Query Beispiel KQL / query example

Path:https://contoso.sharepoint.com/sites/projects/*
ContentTypeId:0x0101*
RefinableString10:"Finance"
IsDocument:1

Result Sources, Query Rules, Dictionaries und Verticals Result sources, query rules, dictionaries, and verticals

Result Sources definieren Query-Transformationen oder begrenzen Suchräume. Query Rules reagieren auf Suchbegriffe und können Result Blocks, Promoted Results oder Query Transformations auslösen. In Microsoft Search und modernen Experiences übernehmen Verticals, Result Layouts und Answer-Typen einen Teil dieser Rolle. Result sources define query transformations or scope search spaces. Query rules react to search terms and can trigger result blocks, promoted results, or query transformations. In Microsoft Search and modern experiences, verticals, result layouts, and answer types take over part of that role.

Dictionaries, Acronyms, Bookmarks und Q&A-Inhalte liegen heute oft näher an Microsoft Search als an klassischer SharePoint Search. Für Offline-Dokumentation ist wichtig, diese Schichten bewusst zu unterscheiden, damit Administratoren nicht veraltete On-Premises-Muster in der Cloud erwarten. Dictionaries, acronyms, bookmarks, and Q&A content today often sit closer to Microsoft Search than to classic SharePoint search. For offline documentation, it is important to distinguish these layers so administrators do not expect outdated on-premises patterns in the cloud.

Experience-Steuerung Experience control

Implementierung Implementation

1. Bestandsaufnahme, Rollen und Abhängigkeiten für Result Sources, Query Rules, Dictionaries und Verticals dokumentieren. Document the current state, roles, and dependencies for Result sources, query rules, dictionaries, and verticals.
2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

• Tenant-Limits, Lizenzzustand und Rollenzuweisungen beeinflussen Result Sources, Query Rules, Dictionaries und Verticals direkt. Tenant limits, license state, and role assignments directly affect Result sources, query rules, dictionaries, and verticals.
• Automatisierung sollte Idempotenz, Logging und Fehlerklassifizierung enthalten. Automation should include idempotency, logging, and error classification.
• Änderungen sollten in Pilotwellen getestet und mit Nutzerkommunikation begleitet werden. Changes should be tested in pilot waves and accompanied by user communication.
• Für Audits lohnt sich eine dokumentierte Soll-Konfiguration mit regelmäßigem Drift-Abgleich. For audits, keep a documented target state and compare for drift regularly.

PnP Modern Search Query PnP Modern Search query

{
  "queryTemplate": "{searchTerms} Path:https://contoso.sharepoint.com/sites/projects",
  "selectedProperties": ["Title","Path","RefinableString10","FileType"],
  "sortList": [{ "property": "LastModifiedTime", "direction": "Descending" }]
}

Search Center und PnP Modern Search Search Center and PnP Modern Search

Ein klassisches Search Center ist weiterhin ein valides Ziel für Ergebnisquellen, Query Rules und themenspezifische Result Pages. Gleichzeitig setzen viele Tenants heute auf PnP Modern Search, um mit SPFx-Webparts, benutzerdefinierten Result Layouts und modernen Refinern flexible Suchoberflächen zu erstellen. A classic search center is still a valid destination for result sources, query rules, and topic-specific result pages. At the same time, many tenants today rely on PnP Modern Search to build flexible search interfaces with SPFx web parts, custom result layouts, and modern refiners.

PnP Modern Search profitiert massiv von sauberem Search Schema. Wer Refiner, Sortierung oder Ergebnisvorlagen ohne konsistente Managed Properties aufbauen will, verschiebt nur Suchprobleme in die UI-Ebene. PnP Modern Search benefits massively from a clean search schema. Trying to build refiners, sorting, or result templates without consistent managed properties only pushes search problems into the UI layer.

PnP Modern Search Web Parts PnP Modern Search web parts

Implementierung Implementation

1. Bestandsaufnahme, Rollen und Abhängigkeiten für Search Center und PnP Modern Search dokumentieren. Document the current state, roles, and dependencies for Search Center and PnP Modern Search.
2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

• Tenant-Limits, Lizenzzustand und Rollenzuweisungen beeinflussen Search Center und PnP Modern Search direkt. Tenant limits, license state, and role assignments directly affect Search Center and PnP Modern Search.
• Automatisierung sollte Idempotenz, Logging und Fehlerklassifizierung enthalten. Automation should include idempotency, logging, and error classification.
• Änderungen sollten in Pilotwellen getestet und mit Nutzerkommunikation begleitet werden. Changes should be tested in pilot waves and accompanied by user communication.
• Für Audits lohnt sich eine dokumentierte Soll-Konfiguration mit regelmäßigem Drift-Abgleich. For audits, keep a documented target state and compare for drift regularly.

PowerShell: PnP Search Settings PowerShell: PnP search settings

Connect-PnPOnline -Url https://contoso.sharepoint.com/sites/search -Interactive
Get-PnPSearchConfiguration -Scope Web
Set-PnPSearchConfiguration -Path .\search-web.xml -Scope Web

PnP PowerShell und Microsoft Search Graph API PnP PowerShell and Microsoft Search Graph API

PnP PowerShell ist das wichtigste Adminwerkzeug für SharePoint-spezifische Suchkonfiguration, insbesondere Export/Import von Search Settings und das Absetzen von Testqueries. Microsoft Graph Search ist dagegen die bevorzugte API für moderne Suchabfragen über SharePoint, OneDrive, externe Verbindungen und weitere Workloads. PnP PowerShell is the most important admin tool for SharePoint-specific search configuration, especially export/import of search settings and issuing test queries. Microsoft Graph search, by contrast, is the preferred API for modern search queries across SharePoint, OneDrive, external connections, and other workloads.

Für Governance empfiehlt sich eine klare Trennung: SharePoint-Admins verantworten Schema und Quelle, App-Entwickler nutzen Graph Search für Experiences. Ohne diese Trennung verschwimmen Zuständigkeiten für Resultqualität und Security Trimming. For governance, it is best to keep a clear separation: SharePoint admins own the schema and source, app developers use Graph Search for experiences. Without this split, ownership for result quality and security trimming becomes blurred.

Werkzeuge und Grenzen Tools and boundaries

Implementierung Implementation

1. Bestandsaufnahme, Rollen und Abhängigkeiten für PnP PowerShell und Microsoft Search Graph API dokumentieren. Document the current state, roles, and dependencies for PnP PowerShell and Microsoft Search Graph API.
2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

• Tenant-Limits, Lizenzzustand und Rollenzuweisungen beeinflussen PnP PowerShell und Microsoft Search Graph API direkt. Tenant limits, license state, and role assignments directly affect PnP PowerShell and Microsoft Search Graph API.
• Automatisierung sollte Idempotenz, Logging und Fehlerklassifizierung enthalten. Automation should include idempotency, logging, and error classification.
• Änderungen sollten in Pilotwellen getestet und mit Nutzerkommunikation begleitet werden. Changes should be tested in pilot waves and accompanied by user communication.
• Für Audits lohnt sich eine dokumentierte Soll-Konfiguration mit regelmäßigem Drift-Abgleich. For audits, keep a documented target state and compare for drift regularly.

HTTP: Graph Search Query HTTP: Graph Search Query

POST https://graph.microsoft.com/v1.0/search/query
Content-Type: application/json

{
  "requests": [
    {
      "entityTypes": ["driveItem","listItem","externalItem"],
      "query": { "queryString": "budget AND site:projects" },
      "from": 0,
      "size": 10
    }
  ]
}

Troubleshooting, Limits und Best Practices Troubleshooting, limits, and best practices

Wenn Inhalte nicht gefunden werden, prüfen Sie zuerst Berechtigungen, Reindex-Auslöser, Managed-Property-Mappings und ob die Experience überhaupt die richtige Suchschicht nutzt. Häufig wird ein Microsoft Search-Problem irrtümlich im klassischen Search Schema gesucht oder umgekehrt. When content is not found, first check permissions, reindex triggers, managed-property mappings, and whether the experience even uses the correct search layer. Often, a Microsoft Search issue is incorrectly investigated in classic search schema or vice versa.

Best Practice ist ein dokumentiertes Search Schema mit Eigentümer pro Managed Property, ein Katalog für genutzte Refinable Slots, standardisierte KQL-Snippets und feste Prüfqueries für Regressionstests nach Informationsarchitektur-Änderungen. Best practice is to maintain a documented search schema with an owner per managed property, a catalog of used refinable slots, standardized KQL snippets, and fixed validation queries for regression tests after information architecture changes.

Typische Limits und Fehler Typical limits and errors

Implementierung Implementation

1. Bestandsaufnahme, Rollen und Abhängigkeiten für Troubleshooting, Limits und Best Practices dokumentieren. Document the current state, roles, and dependencies for Troubleshooting, limits, and best practices.
2. Pilotobjekte mit realistischen Daten und Berechtigungen auswählen. Select pilot objects with realistic data and permissions.
3. Portaländerungen immer mit PowerShell oder API-Abfragen gegenprüfen. Always validate portal changes with PowerShell or API queries.
4. Monitoring, Support-Runbook und Rückfalloptionen vor der Produktion festhalten. Capture monitoring, support runbooks, and rollback options before production rollout.

Betrieb & Hinweise Operations & Notes

• Tenant-Limits, Lizenzzustand und Rollenzuweisungen beeinflussen Troubleshooting, Limits und Best Practices direkt. Tenant limits, license state, and role assignments directly affect Troubleshooting, limits, and best practices.
• Automatisierung sollte Idempotenz, Logging und Fehlerklassifizierung enthalten. Automation should include idempotency, logging, and error classification.
• Änderungen sollten in Pilotwellen getestet und mit Nutzerkommunikation begleitet werden. Changes should be tested in pilot waves and accompanied by user communication.
• Für Audits lohnt sich eine dokumentierte Soll-Konfiguration mit regelmäßigem Drift-Abgleich. For audits, keep a documented target state and compare for drift regularly.

PowerShell: Prüfqueries PowerShell: validation queries

Submit-PnPSearchQuery -Query 'RefinableString10:"Finance"' -SelectProperties Title,Path,RefinableString10
Submit-PnPSearchQuery -Query 'contentclass:STS_ListItem_DocumentLibrary' -All