Utilizar scripts do PowerShell para a Pesquisa restrita do SharePoint

A Pesquisa Restrita do SharePoint foi concebida para clientes de Microsoft 365 Copilot chat e experiências agenteísticas. Foi concebido como uma solução de curto prazo para permitir que os administradores da sua organização revejam e auditem exaustivamente as permissões do site e dos ficheiros, mas não se destina ou é dimensionável para utilização a longo prazo. Estão disponíveis soluções de segurança de dados abrangentes, incluindo a Gestão Avançada do SharePoint e o Microsoft Purview.

Como ativar e gerir a Pesquisa restrita do SharePoint com scripts do PowerShell

Por predefinição, a Pesquisa Restrita do SharePoint não está ativada. Para ativar e configurar a Pesquisa restrita do SharePoint, tem de ter, pelo menos, as permissões de um Administrador do SharePoint no Microsoft 365. Consoante o cenário, algumas ações que precisa de efetuar são:

• Obter o modo atual de Pesquisa restrita
• Ativar e desativar a Pesquisa Restrita
• Adicionar sites à lista de permitidos ao fornecer o URL
• Remover sites da lista de permitidos ao fornecer o URL
• Obter a lista existente de URLs adicionados na lista de permissões

Este artigo aborda como utilizar scripts de administração no PowerShell para estas ações.

Antes de começar

Tem de ser administrador do SharePoint ou ter permissões equivalentes no Microsoft 365 para executar os scripts de administração do PowerShell.

Veja Pré-requisitos da Gestão Avançada do SharePoint.

Antes de utilizar os scripts do PowerShell neste artigo, veja Requisitos do módulo do PowerShell do SharePoint Online.

Obter o modo atual da Pesquisa Restrita do SharePoint

A Pesquisa Restrita do SharePoint está desativada por predefinição. Para verificar o modo atual desta funcionalidade, 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 inquilino. O resultado pode ser "Ativado" ou "Desativado" com base na definição atual.

Ativar ou desativar a Pesquisa Restrita

Ative ou desative a definição Pesquisa Restrita. A predefinição está desativada. Quando ativar a definição pela primeira vez, a lista de permissões está vazia. Para ativar ou desativar 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  

O exemplo 1 define ou ativa o modo de Pesquisa Restrita de Inquilinos para o inquilino.

Exemplo 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled  

O exemplo 2 desativa o modo de Pesquisa Restrita de Inquilinos para o inquilino.

Parameters

-Mode

Define o modo para a Pesquisa Restrita de Inquilinos.

Adicionar sites à lista de permissões

Quando ativar a Pesquisa Restrita do SharePoint, adicione URLs de site à lista de permissões numa cadeia ou ficheiro CSV com 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

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

Parameters

-SitesList

Lista de sites para lista de permissões.

-SitesListFileURL

Ficheiro que tem uma lista de URLs de site que pode adicionar a uma lista de permissões quando o inquilino está definido como Modo de Pesquisa de Inquilino Restrito.

Remover sites da lista de permissões

Remova sites da lista de permissões ao fornecer o URL do site numa cadeia ou ficheiro CSV com 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 ao fornecer um ficheiro CSV.

Parameters

-SitesList

Lista de sites que pretende remover da lista de permissões.

-SitesListFileURL

Ficheiro que tem uma lista de sites que pode remover de uma lista de permissões quando o inquilino está definido como Modo de Pesquisa de Inquilino Restrito.

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

Para obter a lista de URLs existente 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 inquilino.