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 .
Standardmäßig ist die eingeschränkte SharePoint-Suche nicht aktiviert. Zum Aktivieren und Einrichten der eingeschränkten SharePoint-Suche benötigen Sie eine SharePoint-Administratorrolle oder eine höherer Rolle in Microsoft 365. Je nach Szenario müssen Sie folgende Aktionen ausführen:
Abrufen des aktuellen Modus, der für die eingeschränkte Suche festgelegt ist
Aktivieren und Deaktivieren der eingeschränkten SharePoint-Suche
Hinzufügen von Websites zur Liste zulässiger Websites durch Angabe der URL
Entfernen von Websites aus der Liste zulässiger Websites durch Angabe der URL
Abrufen der vorhandenen Liste der URLs, die in der Zulassungsliste hinzugefügt wurden
In diesem Artikel wird beschrieben, wie Sie Administratorskripts in PowerShell für diese Aktionen verwenden.
Vorbereitende Schritte
Sie müssen ein SharePoint-Administrator oder höher in Microsoft 365 sein, um die folgenden Administratorskripts ausführen zu können. Bevor Sie die PowerShell-Skripts in diesem Artikel verwenden, müssen Sie die folgenden Schritte ausführen:
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".
Stellen Sie eine Verbindung mit SharePoint als SharePoint-Administrator oder höher in Microsoft 365 in Microsoft 365 her. Eine Anleitung dazu finden Sie unter Erste Schritte mit der Microsoft Office SharePoint Online-Verwaltungsshell.
Abrufen des aktuellen Modus, der für die eingeschränkte Suche festgelegt ist
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 der Einstellung "Eingeschränkte Suche"
Aktivieren oder deaktivieren Sie die Einstellung Eingeschränkte Suche, wobei die Standardeinstellung deaktiviert ist. Wenn die Einstellung zum ersten Mal aktiviert wird, ist die Zulassungsliste 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
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: | Falsch |
| Platzhalterzeichen akzeptieren: | Falsch |
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
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: | Falsch |
| Platzhalterzeichen akzeptieren: | Falsch |
-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: | Falsch |
| Platzhalterzeichen akzeptieren: | Falsch |
Entfernen von Websites aus der Zulassungsliste
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: | Falsch |
| Platzhalterzeichen akzeptieren: | Falsch |
-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: | Falsch |
| Platzhalterzeichen akzeptieren: | Falsch |
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
```
**Example**
```powershell
Get-SPOTenantRestrictedSearchAllowedList
In diesem Beispiel kann der Administrator die vorhandene Liste der zulässigen Daten im Mandanten abrufen.