Compartilhar via

Utilizar Scripts do PowerShell para a Pesquisa Restrita do SharePoint

Importante

A Pesquisa Restrita do SharePoint foi concebida para clientes do Microsoft 365 Copilot. Visite aqui e a descrição geral da Pesquisa Restrita do SharePoint para obter mais informações.

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:

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.

Antes de utilizar os scripts do PowerShell neste artigo, tem de efetuar os seguintes passos:

  1. Se ainda não o fez, transfira a Shell de Gerenciamento do SharePoint Online mais recente.

    Observação

    Se você instalou uma versão anterior do Shell de Gerenciamento do SharePoint Online, vá até Adicionar ou remover programas e desinstale o "Shell de Gerenciamento do SharePoint Online".

  2. Ligue-se ao SharePoint como Administrador do SharePoint ou com permissões equivalentes no Microsoft 365 no Microsoft 365. Para saber como, consulte Introdução ao Shell de Gerenciamento do SharePoint Online.

A Pesquisa Restrita do SharePoint está desativada por predefinição. Para verificar o modo atual desta funcionalidade, pode executar o seguinte script:

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 definição Pesquisa Restrita com a predefinição a ser desativada. A primeira vez que a definição está ativada, a lista de permissões está vazia. Para ativar ou desativar a Pesquisa Restrita do SharePoint, pode executar:

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 ativado, todos os novos sites criados são excluídos, a menos que sejam adicionados à lista de permitidos.

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

-Modo

Define o modo para a Pesquisa Restrita de Inquilinos.

Tipo String
Posição: 0
Valor Predefinido: Desabilitado
Obrigatório: Verdadeiro
Aceitar entrada de Pipeline: Falso
Aceitar carateres universais: Falso

Adicionar sites à lista de permissões

Quando a Pesquisa Restrita do SharePoint estiver ativada, pode adicionar URLs do site à lista permitida em cadeia ou ficheiro csv:

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 permite ao administrador adicionar os sites à lista de permitidos.

Exemplo 2

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

Observação

Para gerar uma lista de todos os URLs de sites do SharePoint, navegue para o centro de administração online do SharePoint, navegue para Sites Ativos e selecione exportar. A lista exportada também inclui sites clássicos. Remova todos os sites desta lista que não pretenda indexar. Pode incluir até 100 URLs.

Este exemplo permite ao administrador adicionar os sites à lista de permitidos ao fornecer um ficheiro CSV. Adicione a lista de URLs do site na coluna URL.

Parameters

-SitesList

Lista de sites para lista de permitidos.

Tipo String
Posição: 0
Valor Predefinido: Nenhum
Obrigatório: Verdadeiro
Aceitar entrada de Pipeline: Falso
Aceitar carateres universais: Falso

-SitesListFileURL

Ficheiro que tem uma lista de URLs de sites que podem ser adicionados a uma lista permitida quando o inquilino está definido como Modo de Pesquisa de Inquilino Restrito.

Tipo String
Posição: 0
Valor Predefinido: Nenhum
Obrigatório: Verdadeiro
Aceitar entrada de Pipeline: Falso
Aceitar carateres universais: Falso

Remover sites da lista de permissões

Pode remover sites da lista de permitidos ao fornecer o URL do Site em cadeia ou ficheiro csv com o script 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 permite que o administrador remova os sites para a lista de permitidos.

Exemplo 2

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

O exemplo 2 permite que o administrador adicione os sites à lista de permitidos ao fornecer um ficheiro CSV.

Parameters

-SitesList

Lista de sites que será removida da lista de permitidos.

Tipo String
Posição: 0
Valor Predefinido: Nenhum
Obrigatório: Verdadeiro
Aceitar entrada de Pipeline: Falso
Aceitar carateres universais: Falso

-SitesListFileURL

Ficheiro que tem uma lista de sites que podem ser removidos de uma lista de permitidos quando o inquilino está definido como Modo de Pesquisa de Inquilino Restrito.

Tipo String
Posição: 0
Valor Predefinido: Nenhum
Obrigatório: Verdadeiro
Aceitar entrada de Pipeline: Falso
Aceitar carateres universais: Falso

Obter a lista existente de URLs na lista de permitidos

Pode obter a lista de URLs existente na lista de permitidos ao executar o seguinte script do PowerShell:

Get-SPOTenantRestrictedSearchAllowedList

Módulo:Microsoft.Online.SharePoint.PowerShell

Aplica-se ao: SharePoint Online

Sintaxe

Get-SPOTenantRestrictedSearchAllowedList

Exemplo

Get-SPOTenantRestrictedSearchAllowedList

Este exemplo permite que o administrador obtenha a lista de permissões existente no inquilino.

  • Last updated on