Condividi tramite

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

Per eseguire gli script di amministratore seguenti, è necessario essere un amministratore di SharePoint o versione successiva in Microsoft 365. Prima di usare gli script di PowerShell in questo articolo, è necessario seguire questa procedura:

  1. In caso contrario, scaricare la SharePoint Online Management Shell più recente.

    Nota

    Se hai installato una versione precedente di SharePoint Online Management Shell, vai su Installazione applicazioni e disinstallare SharePoint Online Management Shell.

  2. 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.

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 consentiti è 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  

Nota

Una volta abilitati, tutti i nuovi siti creati vengono esclusi a meno che non vengano aggiunti all'elenco consentito.

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

Nota

Per generare un elenco di tutti gli URL del sito di SharePoint, passare all'interfaccia di amministrazione di SharePoint Online, passare a Siti attivi e selezionare Esporta. L'elenco esportato include anche siti classici. Rimuovere tutti i siti da questo elenco che non si desidera indicizzare. È possibile includere fino a 100 URL.

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 consentiti

È 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.