Verwenden von PowerShell-Skripten für die 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 Datenkontrollen wie Restricted Content Discovery (RCD) für die Auffindbarkeit von Inhalten.

Die eingeschränkte SharePoint-Suche ist für Kunden mit Microsoft Copilot Chat und Agentfunktionen 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, aber es ist nicht für eine langfristige Verwendung vorgesehen oder skalierbar. Umfassende Datensicherheitslösungen sind verfügbar, 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. Um die eingeschränkte SharePoint-Suche zu aktivieren und einzurichten, benötigen Sie mindestens die Berechtigungen eines SharePoint-Administrators in Microsoft 365. Je nach Szenario müssen Sie u. a. folgende Aktionen ausführen:

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

Bevor Sie beginnen

Sie müssen 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 SharePoint-Verwaltung.

Bevor Sie die PowerShell-Skripte in diesem Artikel verwenden, lesen Sie die Modulanforderungen für SharePoint Online PowerShell.

Die eingeschränkte SharePoint-Suche ist standardmäßig deaktiviert. Führen Sie den folgenden Befehl aus, um den aktuellen Modus dieses Features zu überprüfen:

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 Zulassungsliste im Mandanten abrufen. Das Ergebnis kann je nach aktueller Einstellung "Aktiviert" oder "Deaktiviert" lauten.

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 Modus "Eingeschränkte Mandantensuche" 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
Lage: 0
Standardwert: Disabled
Erforderlich: True
Akzeptieren Pipelineeingabe: False
Platzhalterzeichen akzeptieren: False

Hinzufügen von Websites zur Zulassungsliste

Wenn Sie die eingeschränkte SharePoint-Suche aktivieren, fügen Sie Website-URLs mit diesem Befehl zur Zulassungsliste in einer Zeichenfolge oder CSV-Datei 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)")

Dieses Beispiel zeigt dem Administrator, wie er die Websites zur Zulassungsliste hinzufügt.

Beispiel 2

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

Hinweis

Um eine Liste aller Ihrer SharePoint-Website-URLs 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.

Dieses Beispiel zeigt dem Administrator, wie er die Websites mithilfe einer CSV-Datei zur Zulassungsliste hinzufügt. Fügen Sie die Liste der Website-URLs in der URL-Spalte hinzu.

Parameter

-SitesList

Websiteliste für Zulassungsliste.

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

-SitesListFileURL

Datei mit einer Liste von Website-URLs, die Sie einer Zulassungsliste hinzufügen können, wenn für den Mandanten der eingeschränkte Mandantensuchmodus festgelegt ist.

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

Entfernen von Websites aus der Zulassungsliste

Entfernen Sie Websites aus der Zulassungsliste, indem Sie die Website-URL mithilfe des folgenden PowerShell-Befehls in einer Zeichenfolge oder CSV-Datei angeben:

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 durch Bereitstellen einer CSV-Datei zur Zulassungsliste hinzufügt.

Parameter

-SitesList

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

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

-SitesListFileURL

Datei mit einer Liste von Websites, die Sie aus einer Zulassungsliste entfernen können, wenn für den Mandanten der eingeschränkte Mandantensuchmodus festgelegt ist.

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

Abrufen der vorhandenen Liste von 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 erhält.