Usare gli script di PowerShell per la ricerca con restrizioni di SharePoint
Importante
La ricerca con restrizioni di SharePoint è progettata per i clienti di Microsoft 365 Copilot. Per altre informazioni, vedere qui e la panoramica di Ricerca sharePoint con restrizioni .
Per impostazione predefinita, La ricerca con restrizioni di SharePoint non è abilitata. Per abilitare e configurare Ricerca sharePoint con restrizioni, è necessario avere un ruolo di amministratore di SharePoint o superiore in Microsoft 365. A seconda dello scenario, alcune azioni che è necessario eseguire sono:
Ottenere la modalità corrente impostata per Ricerca con restrizioni
Abilitare e disabilitare la ricerca con restrizioni di SharePoint
Aggiungere siti all'elenco consentito specificando l'URL
Rimuovere i siti dall'elenco consentito specificando l'URL
Ottenere l'elenco esistente di URL aggiunti nell'elenco consentiti
Questo articolo illustra come usare gli script di amministrazione in PowerShell per queste azioni.
Prima di iniziare
È necessario essere un amministratore di SharePoint o superiore in Microsoft 365 per eseguire gli script di amministrazione seguenti. Prima di usare gli script di PowerShell in questo articolo, è necessario eseguire le operazioni seguenti:
In caso contrario, scaricare la shell di gestione di SharePoint Online più recente.
Nota
Se hai installato una versione precedente di SharePoint Online Management Shell, vai su Installazione applicazioni e disinstallare SharePoint Online Management Shell.
Connettersi a SharePoint come amministratore di SharePoint o versione successiva in Microsoft 365 in Microsoft 365. Per informazioni in merito, vedere Guida introduttiva a SharePoint Online Management Shell.
Ottenere la modalità corrente impostata per Ricerca con restrizioni
La ricerca con restrizioni di SharePoint è disabilitata per impostazione predefinita. Per verificare la modalità corrente di questa funzionalità, è possibile eseguire lo script seguente:
Get-SPOTenantRestrictedSearchMode
Modulo: Microsoft.Online.SharePoint.PowerShell
Si applica a: SharePoint Online
Sintassi
Get-SPOTenantRestrictedSearchMode
Esempio
Get-SPOTenantRestrictedSearchMode
Questo esempio consente all'amministratore di ottenere l'elenco consentito esistente nel tenant. Il risultato può essere "Abilitato" o "Disabilitato" in base all'impostazione corrente.
Abilitare o disabilitare l'impostazione Ricerca con restrizioni
Abilitare o disabilitare l'impostazione Ricerca con restrizioni con il valore predefinito disabilitato. La prima volta che l'impostazione è abilitata l'elenco consenti è vuoto. Per abilitare o disabilitare la ricerca di SharePoint con restrizioni, è possibile eseguire:
Set-SPOTenantRestrictedSearchMode
Modulo: Microsoft.Online.SharePoint.PowerShell
Si applica a: SharePoint Online
Sintassi
Set-SPOTenantRestrictedSearchMode
[-Mode] {Disabled | Enabled}
[<CommonParameters>]
Esempio 1
Set-SPOTenantRestrictedSearchMode -Mode Enabled
Nell'esempio 1 viene impostata o abilitata la modalità Ricerca tenant con restrizioni per il tenant.
Esempio 2
Set-SPOTenantRestrictedSearchMode – Mode Disabled
Nell'esempio 2 viene disabilitata la modalità Ricerca tenant con restrizioni per il tenant.
Parametri
-Modo
Imposta la modalità per La ricerca tenant con restrizioni.
| Tipo | Stringa |
|---|---|
| Posizione: | 0 |
| Valore predefinito: | Disabilitato |
| Obbligatorio: | Vero |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
Aggiungere siti all'elenco consentito
Quando è abilitata la ricerca con restrizioni di SharePoint, è possibile aggiungere gli URL del sito all'elenco consentito nel file stringa o csv:
Add-SPOTenantRestrictedSearchAllowedList
Module:Microsoft.Online.SharePoint.PowerShell
Si applica a: SharePoint Online
Sintassi
Add-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]
Add-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]
[<CommonParameters>]
Esempio 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)”)
Questo esempio consente all'amministratore di aggiungere i siti all'elenco consentito.
Esempio 2
Add-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv
Questo esempio consente all'amministratore di aggiungere i siti all'elenco consentito assegnando un file CSV. Aggiungere l'elenco di URL del sito nella colonna URL.
Parametri
-SitesList
Elenco di siti per l'elenco consentito.
| Tipo | Stringa |
|---|---|
| Posizione: | 0 |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Vero |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
-SitesListFileURL
File con elenco di URL di siti che possono essere aggiunti a un elenco consentito quando il tenant è impostato su Modalità di ricerca tenant con restrizioni.
| Tipo | Stringa |
|---|---|
| Posizione: | 0 |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Vero |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
Rimuovere i siti dall'elenco consenti
È possibile rimuovere i siti dall'elenco consentito specificando l'URL del sito in un file di stringa o csv usando lo script di PowerShell:
Remove-SPOTenantRestrictedSearchAllowedList
Module:Microsoft.Online.SharePoint.PowerShell
Si applica a: SharePoint Online
Sintassi
Remove-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]
Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]
[<CommonParameters>]
Esempio 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)”)
L'esempio 1 consente all'amministratore di rimuovere i siti nell'elenco consentito.
Esempio 2
Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv
L'esempio 2 consente all'amministratore di aggiungere i siti all'elenco consentito assegnando un file CSV.
Parametri
-SitesList
Elenco di siti che verrà rimosso dall'elenco consentito.
| Tipo | Stringa |
|---|---|
| Posizione: | 0 |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Vero |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
-SitesListFileURL
File con elenco di siti che possono essere rimossi da un elenco consentito quando il tenant è impostato su Modalità di ricerca tenant con restrizioni.
| Tipo | Stringa |
|---|---|
| Posizione: | 0 |
| Valore predefinito: | Nessuno |
| Obbligatorio: | Vero |
| Accettare l'input della pipeline: | Falso |
| Accettare caratteri jolly: | Falso |
Ottenere l'elenco esistente di URL nell'elenco consentito
È possibile ottenere l'elenco esistente di URL nell'elenco consentito eseguendo lo script di PowerShell seguente:
Get-SPOTenantRestrictedSearchAllowedList
Module:Microsoft.Online.SharePoint.PowerShell
Si applica a: SharePoint Online
Sintassi
Get-SPOTenantRestrictedSearchAllowedList
```
**Example**
```powershell
Get-SPOTenantRestrictedSearchAllowedList
Questo esempio consente all'amministratore di ottenere l'elenco consentito esistente nel tenant.