Usar scripts do PowerShell para pesquisa restrita do SharePoint

Importante

A Pesquisa Restrita do SharePoint está sendo desativada. A partir de 31 de julho de 2026, a nova ativação será bloqueada. Use controles de dados abrangentes, como RCD (Descoberta de Conteúdo Restrito ) para descoberta de conteúdo.

A Pesquisa Restrita do SharePoint foi projetada para clientes de experiências Microsoft Copilot Chat e agenci. Ele foi projetado como uma solução de curto prazo para dar tempo para que os administradores da sua organização revisem e auditem minuciosamente as permissões de site e arquivo, mas não se destina ou é escalonável para uso a longo prazo. Soluções abrangentes de segurança de dados estão disponíveis, incluindo o Gerenciamento Avançado do SharePoint e o Microsoft Purview.

Como habilitar e gerenciar a Pesquisa restrita do SharePoint usando scripts do PowerShell

Por padrão, a Pesquisa Restrita do SharePoint não está habilitada. Para habilitar e configurar a Pesquisa do SharePoint restrita, você precisa ter pelo menos as permissões de um Administrador do SharePoint no Microsoft 365. Dependendo do cenário, algumas ações que você precisa tomar são:

Este artigo aborda como usar scripts de administrador no PowerShell para essas ações.

Antes de começar

Você deve ser um Administrador do SharePoint ou ter permissões equivalentes no Microsoft 365 para executar os scripts de administração do PowerShell.

Consulte Pré-requisitos para o Gerenciamento Avançado do SharePoint.

Antes de usar os scripts do PowerShell neste artigo, consulte os requisitos do módulo do PowerShell do SharePoint Online.

A Pesquisa Restrita do SharePoint está desabilitada por padrão. Para verificar o modo atual desse recurso, você pode executar o seguinte comando:

Get-SPOTenantRestrictedSearchMode

Módulo: Microsoft.Online.SharePoint.PowerShell

Aplica-se ao: SharePoint Online

Sintaxe

Get-SPOTenantRestrictedSearchMode

Exemplo

Get-SPOTenantRestrictedSearchMode

Este exemplo permite que o administrador obtenha a lista de permissões existente no locatário. O resultado pode ser "Habilitado" ou "Desabilitado" com base na configuração atual.

Habilite ou desabilite a configuração de Pesquisa Restrita. O padrão é desabilitado. Na primeira vez que você habilitar a configuração, a lista de permissões estará vazia. Para habilitar ou desabilitar a Pesquisa Restrita do SharePoint, execute este comando:

Set-SPOTenantRestrictedSearchMode

Módulo: Microsoft.Online.SharePoint.PowerShell

Aplica-se ao: SharePoint Online

Sintaxe

Set-SPOTenantRestrictedSearchMode 
[-Mode] {Disabled | Enabled}
 [<CommonParameters>]

Exemplo 1

Set-SPOTenantRestrictedSearchMode -Mode Enabled

Observação

Depois de habilitado, todos os novos sites serão excluídos, a menos que você os adicione à lista de permissões.

O Exemplo 1 define ou habilita o modo de Pesquisa de Locatário Restrito para o locatário.

Exemplo 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled

O Exemplo 2 desabilita o modo de Pesquisa de Locatário Restrito para o locatário.

Parameters

-Mode

Define o modo para a Pesquisa de Locatário Restrito.

Tipo String
Posição: 0
Valor Padrão: Disabled
Obrigatório: True
Aceitar entrada do pipeline: False
Aceitar caracteres curinga: False

Adicionar sites à lista de permissões

Ao habilitar a Pesquisa Restrita do SharePoint, adicione URLs de sites à lista de permissões em uma cadeia de caracteres ou arquivo CSV usando este comando:

Add-SPOTenantRestrictedSearchAllowedList

Módulo:Microsoft.Online.SharePoint.PowerShell

Aplica-se ao: SharePoint Online

Sintaxe

Add-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]

Add-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]  
 [<CommonParameters>]

Exemplo 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)")

Este exemplo mostra ao administrador como adicionar os sites à lista de permissões.

Exemplo 2

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

Observação

Para gerar uma lista de todas as URLs do site do SharePoint, vá para o centro de administração do SharePoint Online, acesse Sites Ativos e selecione exportar. A lista exportada também inclui sites clássicos. Remova todos os sites desta lista que você não deseja indexar. Você pode incluir até 100 URLs.

Este exemplo mostra ao administrador como adicionar os sites à lista de permissões fornecendo um arquivo CSV. Adicione a lista de URLs de site na coluna URL.

Parameters

-SitesList

Lista de sites para lista de permissões.

Tipo String
Posição: 0
Valor Padrão: None
Obrigatório: True
Aceitar entrada do pipeline: False
Aceitar caracteres curinga: False

-SitesListFileURL

Arquivo que tem uma lista de URLs de sites que você pode adicionar a uma lista de permissões quando o locatário está definido para o Modo de Pesquisa de Locatário Restrito.

Tipo String
Posição: 0
Valor Padrão: None
Obrigatório: True
Aceitar entrada do pipeline: False
Aceitar caracteres curinga: False

Remover sites da lista de permissões

Remova sites da lista de permissões fornecendo a URL do site em uma cadeia de caracteres ou arquivo CSV usando o seguinte comando do PowerShell:

Remove-SPOTenantRestrictedSearchAllowedList

Módulo:Microsoft.Online.SharePoint.PowerShell

Aplica-se ao: SharePoint Online

Sintaxe

Remove-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]

Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]
 [<CommonParameters>]

Exemplo 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)")

O Exemplo 1 mostra como o administrador remove os sites da lista de permissões.

Exemplo 2

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

O exemplo 2 mostra como o administrador adiciona os sites à lista de permissões fornecendo um arquivo CSV.

Parameters

-SitesList

Lista de sites que você deseja remover da lista de permissões.

Tipo String
Posição: 0
Valor Padrão: None
Obrigatório: True
Aceitar entrada do pipeline: False
Aceitar caracteres curinga: False

-SitesListFileURL

Arquivo que tem uma lista de sites que você pode remover de uma lista de permissões quando o locatário está definido para o Modo de Pesquisa de Locatário Restrito.

Tipo String
Posição: 0
Valor Padrão: None
Obrigatório: True
Aceitar entrada do pipeline: False
Aceitar caracteres curinga: False

Obter a lista existente de URLs na lista de permissões

Para obter a lista existente de URLs na lista de permissões, execute o seguinte comando do PowerShell:

Get-SPOTenantRestrictedSearchAllowedList

Módulo:Microsoft.Online.SharePoint.PowerShell

Aplica-se ao: SharePoint Online

Sintaxe

Get-SPOTenantRestrictedSearchAllowedList

Exemplo

Get-SPOTenantRestrictedSearchAllowedList

Este exemplo mostra como o administrador obtém a lista de permissões existente no locatário.

  • Last updated on