Freigeben über

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

Wichtig

Die eingeschränkte SharePoint-Suche wurde für Kunden von Microsoft 365 Copilot entwickelt. Weitere Informationen finden Sie hier und in der Übersicht über die eingeschränkte SharePoint-Suche .

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.

Vorbereitende Schritte

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.

Bevor Sie die PowerShell-Skripts in diesem Artikel verwenden, müssen Sie die folgenden Schritte ausführen:

  1. Falls nicht, laden Sie die neueste SharePoint Online-Verwaltungsshell herunter.

    Hinweis

    Wenn Sie eine frühere Version der Microsoft Office SharePoint Online-Verwaltungsshell installiert haben, gehen Sie zu Programme hinzufügen oder entfernen und deinstallieren Sie "SharePoint Online-Verwaltungsshell".

  2. Stellen Sie eine Verbindung mit SharePoint als SharePoint-Administrator oder mit entsprechenden Berechtigungen in Microsoft 365 in Microsoft 365 her. Eine Anleitung dazu finden Sie unter Erste Schritte mit der Microsoft Office SharePoint Online-Verwaltungsshell.

Die eingeschränkte SharePoint-Suche ist standardmäßig deaktiviert. Um den aktuellen Modus dieses Features zu überprüfen, können Sie das folgende Skript 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, wobei die Standardeinstellung deaktiviert ist. Wenn die Einstellung zum ersten Mal aktiviert wird, ist die Positivliste leer. Um die eingeschränkte SharePoint-Suche zu aktivieren oder zu deaktivieren, können Sie Folgendes ausführen:

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 neu erstellten Websites ausgeschlossen, es sei denn, sie werden der Liste der zulässigen Websites hinzugefügt.

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

-Modus

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

Typ String
Position: 0
Standardwert: Deaktiviert
Erforderlich: Wahr
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

Hinzufügen von Websites zur Liste zulässiger Websites

Wenn die eingeschränkte SharePoint-Suche aktiviert ist, können Sie website-URLs der Liste zulässiger Websites in einer Zeichenfolge oder CSV-Datei hinzufügen:

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 kann der Administrator die Websites der Liste der zulässigen Websites hinzufügen.

Beispiel 2

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

Hinweis

Um eine Liste aller UrLs ihrer SharePoint-Website zu generieren, navigieren Sie zu Ihrem SharePoint Online Admin Center, navigieren 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 kann der Administrator die Websites der Liste zulässiger Websites hinzufügen, indem er eine CSV-Datei angibt. Fügen Sie die Liste der Website-URLs in der URL-Spalte hinzu.

Parameter

-SitesList

Websiteliste für zulässige Liste.

Typ String
Position: 0
Standardwert: Keine
Erforderlich: Wahr
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-SitesListFileURL

Datei mit einer Liste von Website-URLs, die einer Liste zulässiger Websites hinzugefügt werden können, wenn der Mandant auf eingeschränkten Mandantensuchmodus festgelegt ist.

Typ String
Position: 0
Standardwert: Keine
Erforderlich: Wahr
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

Entfernen von Websites aus der Positivliste

Sie können Websites aus der Liste zulässiger Websites entfernen, indem Sie die Website-URL mithilfe eines PowerShell-Skripts 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)")

In Beispiel 1 kann der Administrator die Websites aus der Liste der zulässigen Websites entfernen.

Beispiel 2

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

In Beispiel 2 kann der Administrator die Websites der Liste zulässiger Websites hinzufügen, indem er eine CSV-Datei angibt.

Parameter

-SitesList

Websiteliste, die aus der Liste zulässiger Websites entfernt wird.

Typ String
Position: 0
Standardwert: Keine
Erforderlich: Wahr
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-SitesListFileURL

Datei mit einer Liste von Websites, die aus einer Liste zulässiger Websites entfernt werden können, wenn der Mandant auf eingeschränkter Mandantensuchmodus festgelegt ist.

Typ String
Position: 0
Standardwert: Keine
Erforderlich: Wahr
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

Abrufen der vorhandenen Liste der URLs in der Liste zulässiger UrLs

Sie können die vorhandene Liste der URLs in der Liste zulässiger UrLs abrufen, indem Sie das folgende PowerShell-Skript ausführen:

Get-SPOTenantRestrictedSearchAllowedList

Modul:Microsoft.Online.SharePoint.PowerShell

Gilt für: SharePoint Online

Syntax

Get-SPOTenantRestrictedSearchAllowedList

Beispiel

Get-SPOTenantRestrictedSearchAllowedList

In diesem Beispiel kann der Administrator die vorhandene Liste der zulässigen Daten im Mandanten abrufen.

  • Last updated on