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 chat ed esperienze agentic. È progettato come soluzione a breve termine per consentire agli amministratori dell'organizzazione di esaminare e controllare accuratamente le autorizzazioni per siti e file, ma non è progettato o scalabile per l'uso a lungo termine. Sono disponibili soluzioni complete per la sicurezza dei dati, tra cui Gestione avanzata di SharePoint e Microsoft Purview.

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. Se non è già stato fatto, 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. 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 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

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

-Mode

Imposta la modalità per La ricerca tenant con restrizioni.

Tipo Stringa
Posizione: 0
Valore predefinito: Disabled
Obbligatorio: True
Accettare l'input della pipeline: False
Accettare caratteri jolly: False

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: None
Obbligatorio: True
Accettare l'input della pipeline: False
Accettare caratteri jolly: False

-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: None
Obbligatorio: True
Accettare l'input della pipeline: False
Accettare caratteri jolly: False

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: None
Obbligatorio: True
Accettare l'input della pipeline: False
Accettare caratteri jolly: False

-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: None
Obbligatorio: True
Accettare l'input della pipeline: False
Accettare caratteri jolly: False

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