Partilhar via

Utilizar Scripts do PowerShell para a Pesquisa Restrita do SharePoint

  • Artigo

Importante

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

Por predefinição, a Pesquisa Restrita do SharePoint não está ativada. Para ativar e configurar a Pesquisa Restrita do SharePoint, tem de ter uma função de Administrador do SharePoint ou superior no Microsoft 365. Consoante o cenário, algumas ações que precisa de efetuar são:

  • Obter o modo atual definido para Pesquisa Restrita

  • Ativar e desativar a pesquisa restrita do SharePoint

  • 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 superior no Microsoft 365 para executar os seguintes scripts de administração. Antes de utilizar os scripts do PowerShell neste artigo, tem de fazer o seguinte:

  1. Se ainda não o fez, transfira a Shell de Gestão 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 superior 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

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  

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

  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
```  

**Example**

```powershell
Get-SPOTenantRestrictedSearchAllowedList

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