> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/pt/configuration/mappings/auto-mapping.md).

# Mapeamento automático

O Mapeamento Automático é a funcionalidade do KONNEKT que mapeia automaticamente todos os sites e bibliotecas de documentos do SharePoint Online para o Explorador de Ficheiros do Windows dos utilizadores (e outras caixas de diálogo de ficheiros). Apenas são mapeados os sites e bibliotecas aos quais o utilizador tem acesso.

Os administradores podem controlar esta funcionalidade em dois níveis:

1. Nível do site
2. Nível da biblioteca

O KONNEKT atualiza os mapeamentos a cada 60 minutos.

{% hint style="info" %}
O KONNEKT usa a fonte de resultados predefinida da Pesquisa do SharePoint Online. A modificação desta definição poderá alterar as coleções de sites e bibliotecas de documentos apresentadas.
{% endhint %}

{% hint style="info" %}
Ao usar a definição da Microsoft "[Restringir a descoberta de sites e conteúdo do SharePoint](https://learn.microsoft.com/en-us/sharepoint/restricted-content-discovery)" pode afetar quais coleções de sites são exibidas no KONNEKT.
{% endhint %}

## Âmbito do site

{% hint style="info" %}
Esta política é aplicável à versão 2.0 e superior
{% endhint %}

{% hint style="info" %}
Por predefinição, o KONNEKT mapeará todos os sites de equipa e de comunicação, bem como as respetivas subsites, aos quais o utilizador tenha acesso. Os canais privados do Teams não fazem parte do âmbito predefinido do site.

**Se isso lhe convém, não precisa de usar esta política.**
{% endhint %}

### **Política** Definição

* **Nome da política (ADMX):** `Consulta de Sites do SharePoint`

Esta política permite-lhe definir a cadeia de consulta utilizada para localizar sites do SharePoint.

A consulta do site tem de ser expressa em KQL. Pode encontrar aqui a documentação geral do KQL: <https://docs.microsoft.com/en-us/sharepoint/dev/general-development/keyword-query-language-kql-syntax-reference>

Pode encontrar aqui uma lista de propriedades de consulta para o SharePoint: <https://docs.microsoft.com/en-us/sharepoint/technical-reference/crawled-and-managed-properties-overview>

Pode testar a sua consulta KQL do site neste URL do SharePoint Online:

```
https://<YourTenantName>.sharepoint.com/_layouts/15/osssearchresults.aspx
```

Nos parágrafos seguintes, pode encontrar alguns exemplos de cadeias de consulta KQL.

### Predefinição

Se não configurar esta política, o KONNEKT usará a seguinte consulta KQL predefinida:

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (contentclass=STS_Site OR contentclass=STS_Web)
```

Isto mapeará todos os sites de equipa e de comunicação aos quais o utilizador tenha acesso. Os canais privados do Teams não fazem parte do âmbito predefinido do site

![](/files/1d39e36abbf59816682e9ea122137fc5de920af4)

### Exemplos

#### Lista de permissões de sites

<details>

<summary>Filtrar pelo nome/título do site</summary>

`Title=\"<MySiteName>\"`

**Cadeia de consulta** para mapear apenas os sites "Give" e "Leadership"

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (contentclass=STS_Site OR contentclass=STS_Web) AND (title="Give" OR title="Leadership")
```

**Nota:** é necessário reiniciar o KONNEKT para aplicar a política

</details>

![](/files/294dfd3587a8f3176878cd6cd3fa03337371b782)

{% hint style="info" %}
**Nota:** Para mostrar todos os sites com \<Leadership> no nome, use o operador **(:)** em vez de **(=)** por título
{% endhint %}

#### Lista de permissões de sites usando o operador \*

<details>

<summary>Filtrar pelo nome/título do site usando o operador (*)</summary>

Mostrar todos os sites que tenham uma palavra que comece por Con `title:<"Con*">`

**cadeia de consulta**

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (contentclass=STS_Site OR contentclass=STS_Web) AND (title:"Con*")
```

</details>

{% hint style="info" %}
**Nota**: Não recomendamos combinar o **(=)** operador juntamente com o asterisco **(\*)** quando fizer correspondência exata. Em vez disso, use o **(:)** operador com **(\*)**
{% endhint %}

#### Lista de bloqueio de sites

<details>

<summary>Excluir sites por nome/título do site</summary>

Mapear todos os sites e bibliotecas, exceto sites específicos (e as respetivas bibliotecas)

**cadeia de consulta** a excluir `<Site01>` e `<Site02>`

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (NOT (sitetitle:"Site01" OR sitetitle:"Site02"))
```

**Nota:** é necessário reiniciar o KONNEKT para aplicar a política

</details>

#### canais privados e partilhados do Teams

<details>

<summary>Adicionar canais privados e partilhados do Microsoft Teams</summary>

Mapear todos os sites SP, canais privados do Teams e canais partilhados do Teams

Ao adicionar `webtemplate:TEAMCHANNEL` à consulta

**cadeia de consulta**

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING OR webtemplate:TEAMCHANNEL) AND (contentclass=STS_Site OR contentclass=STS_Web)
```

**Nota:** é necessário reiniciar o KONNEKT para aplicar a política

Como os canais privados e partilhados são sites dedicados no SharePoint, aparecem como volumes dedicados no KONNEKT.

</details>

#### Todas as subsites para vários sites do SharePoint

<details>

<summary>Mostrar todas as subsites de um ou mais sites do SharePoint</summary>

Para mapear todas as subsites (e bibliotecas) de um ou mais sites do SharePoint, pode usar a seguinte consulta

**cadeia de consulta**

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (contentclass=STS_Site OR contentclass=STS_Web) AND (path:https://<YourTenantName>.sharepoint.com/sites/MySite1 OR path:https://<YourTenantName>.sharepoint.com/sites/MySite2)
```

**Nota:** altere MySite1 e MySite2 para os nomes dos seus sites do SharePoint.

Pode mapear subsites e bibliotecas de apenas um site do SharePoint ou até adicionar vários URLs, se necessário

</details>

### **Há várias maneiras de aplicar a política:**

* manualmente, adicionando a chave no registro nas configurações de registro da máquina ou do usuário
* através da GPO, [verificar as definições através da GPO](/pt/configuration/management-options/settings-via-gpo.md)
* aplicando políticas via Intune, veja [definições para dispositivos gerenciados pelo Intune](/pt/configuration/management-options/setting-for-intune-managed-devices-1/intune-mappings.md#sharepoint-site-query)

#### **Definição manual no registo**

{% hint style="info" %}
Não precisa disto se utilizar gestão por GPO ou Intune.
{% endhint %}

* **Nome do valor de registo:** `SharepointSiteQuery`
* **Tipo do valor de registo:** `REG_SZ`
* **Dados do valor de registo:** cadeia KQL
* **Local de armazenamento do valor de registo**:
  * `HKEY_CURRENT_USER\SOFTWARE\Policies\glueckkanja\Konnekt`\
    ou
  * `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\glueckkanja\Konnekt`

## Âmbito da biblioteca

### Mapear as bibliotecas de documentos predefinidas

Se ativada, a definição "Ativar sites do SharePoint" apresentará todas as bibliotecas predefinidas de todas as coleções de sites às quais um utilizador tenha acesso.

Um utilizador pode definir esta opção através do menu de preferências:

![](/files/281491ee01524213201140f50daf18b7ca6c38e9)

Também pode ser configurada através do registo/GPO/MDM:

**Nome da política (ADMX):** Descoberta automática de Sites do SharePoint

![](/files/af711e6ab5f30b30572b55dcc0696f794ce88758)

#### Registo

Nome da chave: **O365SharepointUsage**\
Tipo de chave: REG\_DWORD

Ativar ou desativar o acesso a sites do SharePoint Online.

|   Função  |             Valor             | Comportamento                                                                                                                                                |
| :-------: | :---------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Desativar |               0               | O KONNEKT mapeia apenas a biblioteca do OneDrive for Business.                                                                                               |
|   Ativar  | <p>1</p><p>(predefinição)</p> | O KONNEKT mapeia o OneDrive for Business e todas as bibliotecas de documentos predefinidas dos sites do SharePoint Online aos quais o utilizador tem acesso. |

O valor predefinido é 1 (ativado).

Recomendamos usar o nosso [modelo ADMX](/pt/configuration/management-options/settings-via-gpo.md#admx-file) para configurar essa definição.

### Mapear todas as bibliotecas de documentos

Pode encontrar esta definição no menu de preferências:

![](/files/f5fb89db017784b9606d68f9b62d2459a8bf6c8d)

{% hint style="info" %}
Certifique-se de reiniciar **KONNEKT** depois de alterar esta definição.
{% endhint %}

Também pode configurar esta definição através do registo/GPO/MDM:

**Nome da política (ADMX):** Adicionar todas as bibliotecas do SharePoint

![](/files/eef0f68806741e69a85e53de3cc63f950824584a)

#### Registo

Nome da chave: **AddAllSharepointLibraries**\
Tipo: REG\_DWORD

|   Função  |             Valor             | Comportamento                                                                                                                                                                                                 |
| :-------: | :---------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Desativar | <p>0</p><p>(predefinição)</p> | <p>O KONNEKT mapeará apenas a biblioteca de documentos predefinida dos sites do SharePoint Online.</p><p>O formato do endereço UNC é:<br><code>\OneDrive-\<tenant-name>\&#x3C;site-name>...</code></p>        |
|   Ativar  |               1               | <p>O KONNEKT mapeará todas as bibliotecas de documentos do site do SharePoint Online.</p><p>O formato do endereço UNC é:<br><code>\OneDrive-\<tenant-name>\&#x3C;site-name>\&#x3C;library-name>...</code></p> |

O valor predefinido é 0 (desativado)

{% hint style="danger" %}
Se os utilizadores da sua empresa estiverem a usar valores diferentes desta definição, os respetivos caminhos UNC não serão compatíveis entre si (por exemplo, quando trocarem ligações UNC).

Para evitar isso, certifique-se de que esta definição está corretamente configurada para todos os utilizadores.
{% endhint %}

Recomendamos usar o nosso [modelo ADMX](/pt/configuration/management-options/settings-via-gpo.md#admx-file) para configurar essa definição.

## **Há várias maneiras de aplicar a política:**

* manualmente, adicionando a chave no registro nas configurações de registro da máquina ou do usuário
* via GPO, veja [definições via GPO](/pt/configuration/management-options/settings-via-gpo.md)
* aplicando políticas via Intune, veja [definições para dispositivos gerenciados pelo Intune](/pt/configuration/management-options/setting-for-intune-managed-devices-1/intune-mappings.md#add-sharepoint-libraries)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.konnekt.io/pt/configuration/mappings/auto-mapping.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
