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 .

Come abilitare e gestire ricerca di SharePoint con restrizioni tramite script di PowerShell

Per impostazione predefinita, La ricerca con restrizioni di SharePoint non è abilitata. Per abilitare e configurare Ricerca sharePoint con restrizioni, è necessario disporre almeno delle autorizzazioni di un amministratore di SharePoint in Microsoft 365. A seconda dello scenario, alcune azioni che è necessario eseguire sono:

Questo articolo illustra come usare gli script di amministrazione in PowerShell per queste azioni.

Prima di iniziare

È necessario essere un amministratore di SharePoint o avere autorizzazioni equivalenti in Microsoft 365 per eseguire gli script di amministratore di PowerShell.

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 con autorizzazioni equivalenti 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 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

Esempio

Get-SPOTenantRestrictedSearchAllowedList

Questo esempio consente all'amministratore di ottenere l'elenco consentito esistente nel tenant.

  • Last updated on