Verwenden von PowerShell-Skripts für eingeschränkte SharePoint-Suche

Wichtig

Die eingeschränkte SharePoint-Suche wird eingestellt. Ab dem 31. Juli 2026 ist die neue Aktivierung blockiert. Verwenden Sie umfassende Datensteuerelemente wie die eingeschränkte Inhaltsermittlung (Restricted Content Discovery , RCD) für die Auffindbarkeit von Inhalten.

Die eingeschränkte SharePoint-Suche ist für Kunden von Microsoft 365 Copilot Chat- und Agent-Umgebungen konzipiert. Es ist als kurzfristige Lösung konzipiert, um den Administratoren Ihrer organization Zeit zu geben, Website- und Dateiberechtigungen gründlich zu überprüfen und zu überwachen, ist aber nicht für die langfristige Verwendung vorgesehen oder skalierbar. Es stehen umfassende Datensicherheitslösungen zur Verfügung, einschließlich Erweiterte SharePoint-Verwaltung und Microsoft Purview.

Aktivieren und Verwalten der eingeschränkten SharePoint-Suche mithilfe von PowerShell-Skripts

Standardmäßig ist die eingeschränkte SharePoint-Suche nicht aktiviert. Zum Aktivieren und Einrichten der eingeschränkten SharePoint-Suche müssen Sie mindestens über die Berechtigungen eines SharePoint-Administrators in Microsoft 365 verfügen. Je nach Szenario müssen Sie folgende Aktionen ausführen:

In diesem Artikel wird beschrieben, wie Sie Administratorskripts in PowerShell für diese Aktionen verwenden.

Bevor Sie beginnen

Sie müssen Ein SharePoint-Administrator sein oder über entsprechende Berechtigungen in Microsoft 365 verfügen, um die PowerShell-Administratorskripts ausführen zu können.

Weitere Informationen finden Sie unter Voraussetzungen für die erweiterte Verwaltung von SharePoint.

Bevor Sie die PowerShell-Skripts in diesem Artikel verwenden, lesen Sie die SharePoint Online PowerShell-Modulanforderungen.

Die eingeschränkte SharePoint-Suche ist standardmäßig deaktiviert. Um den aktuellen Modus dieses Features zu überprüfen, können Sie den folgenden Befehl ausführen:

Get-SPOTenantRestrictedSearchMode

Modul: Microsoft.Online.SharePoint.PowerShell

Gilt für: SharePoint Online

Syntax

Get-SPOTenantRestrictedSearchMode

Beispiel

Get-SPOTenantRestrictedSearchMode

In diesem Beispiel kann der Administrator die vorhandene Liste der zulässigen Daten im Mandanten abrufen. Das Ergebnis kann basierend auf der aktuellen Einstellung "Aktiviert" oder "Deaktiviert" sein.

Aktivieren oder deaktivieren Sie die Einstellung Eingeschränkte Suche. Der Standardwert lautet disabled. Wenn Sie die Einstellung zum ersten Mal aktivieren, ist die Zulassungsliste leer. Führen Sie den folgenden Befehl aus, um die eingeschränkte SharePoint-Suche zu aktivieren oder zu deaktivieren:

Set-SPOTenantRestrictedSearchMode

Modul: Microsoft.Online.SharePoint.PowerShell

Gilt für: SharePoint Online

Syntax

Set-SPOTenantRestrictedSearchMode 
[-Mode] {Disabled | Enabled}
 [<CommonParameters>]

Beispiel 1

Set-SPOTenantRestrictedSearchMode -Mode Enabled  

Hinweis

Nach der Aktivierung werden alle neuen Websites ausgeschlossen, es sei denn, Sie fügen sie der Zulassungsliste hinzu.

In Beispiel 1 wird der Eingeschränkte Mandantensuchmodus für den Mandanten festgelegt oder aktiviert.

Beispiel 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled  

Beispiel 2 deaktiviert den eingeschränkten Mandantensuchmodus für den Mandanten.

Parameter

-Mode

Legt den Modus für die eingeschränkte Mandantensuche fest.

Typ String
Position: 0
Standardwert: Disabled
Erforderlich: True
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

Hinzufügen von Websites zur Zulassungsliste

Wenn Sie die eingeschränkte SharePoint-Suche aktivieren, fügen Sie website-URLs der Zulassungsliste in einer Zeichenfolge oder CSV-Datei mit dem folgenden Befehl hinzu:

Add-SPOTenantRestrictedSearchAllowedList

Modul:Microsoft.Online.SharePoint.PowerShell

Gilt für: SharePoint Online

Syntax

Add-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]
Add-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]  
 [<CommonParameters>]

Beispiel 1

Add-SPOTenantRestrictedSearchAllowedList -SitesList @("[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)", "[https://contoso.sharepoint.com/sites/Benefits](https://contoso.sharepoint.com/sites/Benefits)")

In diesem Beispiel wird dem Administrator gezeigt, wie die Websites der Zulassungsliste hinzugefügt werden.

Beispiel 2

Add-SPOTenantRestrictedSearchAllowedList  -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

Hinweis

Um eine Liste aller UrLs ihrer SharePoint-Website zu generieren, wechseln Sie zu Ihrem SharePoint Online Admin Center, wechseln Sie zu Aktive Websites, und wählen Sie Exportieren aus. Die exportierte Liste enthält auch klassische Websites. Entfernen Sie alle Websites aus dieser Liste, die nicht indiziert werden sollen. Sie können bis zu 100 URLs einschließen.

In diesem Beispiel wird dem Administrator gezeigt, wie die Websites der Zulassungsliste hinzugefügt werden, indem er eine CSV-Datei bereitstellt. Fügen Sie die Liste der Website-URLs in der URL-Spalte hinzu.

Parameter

-SitesList

Websiteliste für die Zulassungsliste.

Typ String
Position: 0
Standardwert: None
Erforderlich: True
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-SitesListFileURL

Datei mit einer Liste von Website-URLs, die Sie einer Zulassungsliste hinzufügen können, wenn der Mandant auf eingeschränkten Mandantensuchmodus festgelegt ist.

Typ String
Position: 0
Standardwert: None
Erforderlich: True
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

Entfernen von Websites aus der Zulassungsliste

Entfernen Sie Websites aus der Zulassungsliste, indem Sie die Website-URL in einer Zeichenfolgen- oder CSV-Datei angeben, indem Sie den folgenden PowerShell-Befehl verwenden:

Remove-SPOTenantRestrictedSearchAllowedList

Modul:Microsoft.Online.SharePoint.PowerShell

Gilt für: SharePoint Online

Syntax

Remove-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]
Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]
 [<CommonParameters>]

Beispiel 1

Remove-SPOTenantRestrictedSearchAllowedList -SitesList @("[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)", "[https://contoso.sharepoint.com/sites/HR](https://contoso.sharepoint.com/sites/HR)")

Beispiel 1 zeigt, wie der Administrator die Websites aus der Zulassungsliste entfernt.

Beispiel 2

Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

Beispiel 2 zeigt, wie der Administrator die Websites der Zulassungsliste hinzufügt, indem er eine CSV-Datei bereitstellt.

Parameter

-SitesList

Websiteliste, die Sie aus der Zulassungsliste entfernen möchten.

Typ String
Position: 0
Standardwert: None
Erforderlich: True
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-SitesListFileURL

Datei mit einer Liste von Websites, die Sie aus einer Zulassungsliste entfernen können, wenn der Mandant auf eingeschränkten Mandantensuchmodus festgelegt ist.

Typ String
Position: 0
Standardwert: None
Erforderlich: True
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

Abrufen der vorhandenen Liste der URLs in der Zulassungsliste

Führen Sie den folgenden PowerShell-Befehl aus, um die vorhandene Liste der URLs in der Zulassungsliste abzurufen:

Get-SPOTenantRestrictedSearchAllowedList

Modul:Microsoft.Online.SharePoint.PowerShell

Gilt für: SharePoint Online

Syntax

Get-SPOTenantRestrictedSearchAllowedList

Beispiel

Get-SPOTenantRestrictedSearchAllowedList

Dieses Beispiel zeigt, wie der Administrator die vorhandene Zulassungsliste im Mandanten abruft.