# Managed mappings

{% hint style="info" %}
This policy is applicable to version 2.0 and above
{% endhint %}

## Policy description

By using the feature Managed Mappings (policy name `"Sharepoint Sites"`), you can map specific SharePoint sites and libraries to your KONNEKT. You can additionally define drive letters to those mappings.

{% hint style="info" %}
If enabled, this setting will map drives regardless of a users permissions. 
{% endhint %}

To add mappings, go to the policy and click on **Show\...**

![](/files/-MhNYGTgWW-aPhfM96Qs)

![](/files/kR5k6rvC1O7vyahTQqgr)

{% hint style="info" %}
Using this policy for drive-letter mapping will always map the default document library as root.

To map all libraries of one site you need to map the site and enable the policy [AddAllSharePointLibraries](/configuration/mappings/auto-mapping.md#map-all-document-libraries)

If you specify a library in the URL, only this library will be directly mapped. 

This policy does not support folder mapping, for folder mapping please use **net use**  as described [here](/configuration/mappings/assign-drive-letters.md#assign-drive-letters-to-other-folders-using-net-use).

We have a feature-request in the backlog to improve the flexibility of mappings in a future version of KONNEKT.
{% endhint %}

{% hint style="warning" %}
SharePoint **Subsites** are **currently not supported** with KONNEKT Managed Mappings. Please use Auto Mapping to use Subsites with KONNEKT, instead.

We have a feature-request in the backlog to improve the flexibility of mappings in a future version of KONNEKT.

Please also note [Microsoft's recommendations regarding subsites](https://learn.microsoft.com/en-us/office365/servicedescriptions/sharepoint-online-service-description/sharepoint-online-limits#subsites), as subsites have limited scalability and can cause performance issues.
{% endhint %}

## **Policy definition**

**Policy name:** `Sharepoint Sites` 

**Syntax of site definition:** 

```
<sharepoint-url>[|<Name>[|<DriveLetter>[|<TenantName>[|<Favorite>]]]]
```

* <mark style="background-color:blue;">`<sharepoint-url>:`</mark> Your sharepoint site/library URL. Must be URL encoded (e.g. Spaces are represented by `%20`).\
  If you are mapping your root site (requires KONNEKT 2.7.0 or newer), please make sure to have a slash at the end of the <mark style="background-color:blue;">`<sharepoint-url>`</mark> .  Example:\
  Your root site: `https://contoso.sharepoint.com`\
  The Managed Mapping should look like this: `https://contoso.sharepoint.com/|RootSite|R:`
* `<Name>:` Name you choose for the mapped site. This name must be unique for each mapping.\
  \&#xNAN;*optional => value may be empty*
* `<DriveLetter>:` Drive letter for drive mapping.\
  \&#xNAN;*optional => value may be empty*
* `<TenantName>:` Microsoft365 tenant-name for the corresponding account that must be used to access this site. (\<TenantName>.onmicrosoft.com).\
  \&#xNAN;*optional => value may be empty*
* `<Favorite>:` Indicate if mapping shall be a KONNEKT favorite. You must run KONNEKT 2.2.1 or newer for this feature to work properly.\
  Possible values:\
  \- `FALSE` (default)\
  \- `TRUE`\
  \&#xNAN;*optional => value may be empty*

**Site mapping result:**

![](/files/-MhSVkSm0f_ANwwCiL_w)

**Drive mapping result:**

![](/files/-MhSUyyroUR533LcXaYZ)

## **Examples**

#### All libraries of a site

```
https://mytenant.sharepoint.com/sites/mysite
```

This will map the **default document library** of this site. The drive will be labeled as "mysite"

{% hint style="info" %}
To map all libraries you need to enable the policy [AddAllSharePointLibraries](/configuration/mappings/auto-mapping.md#map-all-document-libraries)
{% endhint %}

#### Dedicated library of a site

```
https://mytenant.sharepoint.com/sites/mysite/Shared%20Documents|MySite Docs
```

This will add the "shared documents" library of the site "mysite". The Drive will be labeled "MySite Docs".

#### Assign a drive letter

```
https://mytenant.sharepoint.com/sites/mysite/Shared%20Documents|MySite Docs|M:
```

This will add the "shared documents" library of the site "mysite". The Drive will be labeled "MySite Docs". The network path will be mapped to drive M.

#### Map foreign tenant

```
https://foreignTenant.sharepoint.com/sites/mysite||X:|ForeignTenant
```

This will add all document libraries of the site "mysite", from the tenant "ForeignTenant.onmicrosoft.com". The network path will be mapped to drive X.&#x20;

The user must have an account configured in KONNEKT, that belongs to the Microsoft Entra ID (Azure AD) in the tenant "ForeignTenant".

#### Make mapping a KONNEKT favorite

```
https://mytenant.sharepoint.com/sites/mysite/Shared%20Documents|MySite Docs|||TRUE
```

This will add the "shared documents" library of the site "mysite". The Drive will be labeled "MySite Docs". It will be added as KONNEKT favorite.

## **There are several ways to apply the policy**

1. via GPO, see [settings via GPO](/configuration/management-options/settings-via-gpo.md)
2. pushing policies via Intune, see [settings for Intune Managed Devices](/configuration/management-options/setting-for-intune-managed-devices-1.md)
3. manually by adding the key in the registry under machine or user registry settings

{% hint style="warning" %}
We highly recommend to use 1. or 2., since this policy has several components.
{% endhint %}

## Manual setting in registry

{% hint style="info" %}
You do not need this, if you use GPO or Intune management.
{% endhint %}

The policy consists of two components in the registry:

1. **Value** (activate the feature)
2. **Key with value per mapping** (describe every single mapping)

#### **1. Value**

* **Value name:** `SharepointSites`
* **Value type:** `REG_DWORD`
* **Value data:** `1` (to activate the feature)
* Value **stored** in:
  * `HKEY_CURRENT_USER\SOFTWARE\Policies\GlueckKanja\Konnekt`\
    or
  * `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\GlueckKanja\Konnekt`

#### **2. Key with value per mapping**

* **Key name:** `SharepointSites`
* Key **stored** in:
  * `HKEY_CURRENT_USER\SOFTWARE\Policies\GlueckKanja\Konnekt`\
    or
  * `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\GlueckKanja\Konnekt`

Under this key, one value/data entry has to be generated per mapping:

* **Value name:** equals Value data
* **Value type:** `REG_SZ`
* **Value data:** see [Policy definition](#policy-definition).
* Value **stored** in:
  * `HKEY_CURRENT_USER\SOFTWARE\Policies\GlueckKanja\Konnekt\SharepointSites`\
    or
  * `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\GlueckKanja\Konnekt\SharepointSites`


---

# Agent Instructions: 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:

```
GET https://docs.konnekt.io/configuration/mappings/managed-mappings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.