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

Importante

La ricerca di SharePoint con restrizioni verrà ritirata. A partire dal 31 luglio 2026, la nuova abilitazione è bloccata. Usa controlli completi dei dati, ad esempio Individuazione contenuto limitata per l'individuazione dei contenuti.

La ricerca di SharePoint con restrizioni è progettata per i clienti di esperienze Microsoft Copilot Chat e agenti. È progettato come soluzione a breve termine per consentire agli amministratori dell'organizzazione di rivedere e controllare in modo approfondito le autorizzazioni di siti e file, ma non è destinato o scalabile per l'uso a lungo termine. Sono disponibili soluzioni complete per la sicurezza dei dati, tra cui Gestione avanzata SharePoint e Microsoft Purview.

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

Per impostazione predefinita, la ricerca di SharePoint con restrizioni non è abilitata. Per abilitare e configurare la ricerca di SharePoint con restrizioni, è necessario avere almeno le autorizzazioni di un amministratore di SharePoint in Microsoft 365. A seconda dello scenario, è necessario eseguire alcune azioni:

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

Prima di iniziare

Per eseguire gli script di amministrazione di PowerShell, è necessario essere un amministratore di SharePoint o avere autorizzazioni equivalenti in Microsoft 365.

Vedere Prerequisiti per la gestione avanzata di SharePoint.

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

La ricerca di SharePoint con restrizioni è 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 di indirizzi consentiti esistente nel tenant. Il risultato può essere "Abilitato" o "Disabilitato" in base all'impostazione corrente.

Abilita o disabilita 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 dei consentiti.

L'esempio 1 imposta o abilita la modalità di ricerca tenant con restrizioni per il tenant.

Esempio 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled

L'esempio 2 disabilita la modalità di ricerca tenant con restrizioni per il tenant.

Parametri

-Mode

Imposta la modalità per la ricerca del tenant con restrizioni.

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

Aggiungere siti all'elenco Consenti

Quando si abilita la ricerca di SharePoint con restrizioni, aggiungere gli URL dei siti 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 dei siti di SharePoint, passare all'interfaccia di amministrazione di SharePoint Online, passare a Siti attivi e selezionare Esporta. L'elenco esportato include anche i siti classici. Rimuovere dall'elenco tutti i siti che non si desidera indicizzare. È possibile includere fino a 100 URL.

Questo esempio mostra all'amministratore come aggiungere i siti all'elenco Consenti fornendo un file CSV. Aggiungi l'elenco degli URL del sito nella colonna URL.

Parametri

-SitesList

Elenco siti per l'elenco consentiti.

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

-SitesListFileURL

File con elenco di URL di siti che è possibile aggiungere a un elenco di indirizzi consentiti quando il tenant è impostato sulla modalità di ricerca tenant con restrizioni.

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

Rimuovere i siti dall'elenco Consenti

Rimuovere i siti dall'elenco Consenti fornendo l'URL del sito in una stringa o in un file 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 dei consentiti.

Esempio 2

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

L'esempio 2 mostra come l'amministratore aggiunge i siti all'elenco Consenti fornendo un file CSV.

Parametri

-SitesList

Elenco di siti da rimuovere dall'elenco dei siti consentiti.

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

-SitesListFileURL

File con elenco di siti che è possibile rimuovere da un elenco di siti consentiti quando il tenant è impostato sulla modalità di ricerca tenant con restrizioni.

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

Ottenere l'elenco esistente di URL nell'elenco Consenti

Per ottenere l'elenco esistente di URL nell'elenco dei consentiti, 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 indirizzi consentiti esistente nel tenant.

  • Last updated on