Usare gli script di PowerShell per la ricerca di SharePoint con restrizioni

Importante

Ricerca di SharePoint con restrizioni si ritira. A partire dal 31 luglio 2026, la nuova abilitazione viene bloccata. Usare controlli dati completi, ad esempio l'individuazione di contenuto con restrizioni (RCD, Restricted Content Discovery) per l'individuazione del contenuto.

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

Vedere Prerequisiti per La gestione avanzata di SharePoint.

Prima di usare gli script di PowerShell in questo articolo, vedere Requisiti del modulo PowerShell per SharePoint Online.

La ricerca con restrizioni di SharePoint è disabilitata per impostazione predefinita. Per verificare la modalità corrente di questa funzionalità, è possibile eseguire il comando 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. L'impostazione predefinita è disabled. La prima volta che si abilita l'impostazione, l'elenco consenti è vuoto. Per abilitare o disabilitare la ricerca di SharePoint con restrizioni, eseguire questo comando:

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 vengono esclusi a meno che non vengano aggiunti all'elenco consenti.

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 consenti

Quando si abilita Ricerca SharePoint con restrizioni, aggiungere gli URL del sito all'elenco consenti in un file stringa o CSV usando questo comando:

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 mostra all'amministratore come aggiungere i siti all'elenco consenti.

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 illustra all'amministratore come aggiungere i siti all'elenco consentiti fornendo un file CSV. Aggiungere l'elenco di URL del sito nella colonna URL.

Parametri

-SitesList

Elenco di siti per l'elenco consenti.

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 del sito che è possibile aggiungere a un elenco consenti 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

Rimuovere i siti dall'elenco consentiti specificando l'URL del sito in un file di stringa o CSV usando il comando di PowerShell seguente:

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 mostra come l'amministratore rimuove i siti dall'elenco consentiti.

Esempio 2

Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

Nell'esempio 2 viene illustrato come l'amministratore aggiunge i siti all'elenco consentiti fornendo un file CSV.

Parametri

-SitesList

Elenco di siti che si desidera rimuovere dall'elenco consenti.

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 è possibile rimuovere da un elenco consentiti 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 consenti

Per ottenere l'elenco esistente di URL nell'elenco consenti, eseguire il comando di PowerShell seguente:

Get-SPOTenantRestrictedSearchAllowedList

Module:Microsoft.Online.SharePoint.PowerShell

Si applica a: SharePoint Online

Sintassi

Get-SPOTenantRestrictedSearchAllowedList

Esempio

Get-SPOTenantRestrictedSearchAllowedList

Questo esempio mostra come l'amministratore ottiene l'elenco di autorizzazioni esistenti nel tenant.

  • Last updated on