> 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/de/troubleshooting.md).

# Problembehandlung

Beginnen Sie hier, wenn etwas nicht funktioniert. Befolgen Sie diese Schritte, um Ihr Problem zu identifizieren und zur relevanten Lösungsseite zu springen.

## Bevor Sie beginnen

Wenn **mehrere Benutzer gleichzeitig dasselbe Problem melden**, oder wenn KONNEKT-Debugprotokolle Graph-API-Fehler anzeigen (HTTP 429, 500, 503, 504 oder `UnknownError`), liegt die Ursache möglicherweise im Microsoft 365-Backend und nicht in KONNEKT. Bestätigen Sie dies zuerst: [Dateiprobleme mit Graph Explorer reproduzieren](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).

## Was ist das Problem?

### KONNEKT-Laufwerke oder -Freigaben sind nicht sichtbar

1. **Ist KONNEKT installiert?**
   * Prüfen: `Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -like "*Konnekt*" }`
   * Nicht installiert → [KONNEKT installieren](https://docs.konnekt.io/installation/setup)
   * Stellen Sie auf ARM64-Geräten sicher, dass Sie die ARM64-Version installiert haben. Eine x64-Installation auf ARM64 scheint zwar erfolgreich zu sein, aber der Treiber wird nicht geladen. → [Gerät konnte nicht geöffnet werden](https://docs.konnekt.io/troubleshooting/failed-to-open-device)
2. **Wurde das Gerät nach der Installation neu gestartet?**
   * KONNEKT erfordert einen Neustart, um den Kernelmodus-Treiber zu laden. Starten Sie neu und prüfen Sie erneut.
3. **Läuft der KONNEKT-Dienst?**
   * Prüfen: `Get-Service -Name "Konnekt*"`
   * Wird nicht ausgeführt → Dienst neu starten oder neu installieren.
4. **Ist der Benutzer angemeldet?**
   * Rechtsklick auf das KONNEKT-Symbol im Infobereich → **Konten**. Wenn kein Konto aufgeführt ist, melden Sie sich an.
   * "Admin-Genehmigung erforderlich" → [Mandantenweite Administratoreinwilligung gewähren](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
5. **Laufwerk oder Freigabe ist sichtbar, aber beim Klicken passiert nichts?**
   * → [Klicken auf eine Freigabe bewirkt nichts](https://docs.konnekt.io/troubleshooting/clicking-a-share-does-nothing)

### Sites oder Bibliotheken fehlen

1. **Auto-Mapping verwenden?**
   * Prüfen Sie, dass `O365SharepointUsage = 1` in der Registrierung.
   * Vergewissern Sie sich, dass der Benutzer im SharePoint-Webinterface Zugriff auf die Site hat.
   * Prüfen Sie die KQL-Site-Abfrage – eine restriktive Abfrage kann die Site ausschließen. Siehe [Auto mapping](https://docs.konnekt.io/configuration/mappings/auto-mapping).
   * Überprüfen Sie die Microsoft Entra ID-Gruppenmitgliedschaft des Benutzers, wenn Sites nach Gruppe gefiltert werden.
   * Site-Besitzer, aber kein Mitglied? Die Ermittlung von KONNEKT findet nur Sites, bei denen der Benutzer **Mitglied** ist. → [Einige Sites oder Bibliotheken werden in KONNEKT nicht angezeigt](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)
2. **Verwenden Sie verwaltete Zuordnungen?**
   * Prüfen Sie, dass die `SharepointSites` -Richtlinie angewendet wird: `gpresult /r` oder prüfen Sie die Registrierung.
   * Vergewissern Sie sich, dass die SharePoint-URL in der Richtlinie korrekt und zugänglich ist.
3. **Versuchen Sie, eine Freigabe manuell hinzuzufügen, und erhalten Sie "Fehler beim Öffnen der Site: Schlüssel nicht gefunden"?**
   * → [Freigabe hinzufügen: "Schlüssel nicht gefunden"](https://docs.konnekt.io/troubleshooting/add-share-key-not-found)
4. **Site ist in SharePoint vorhanden, aber nicht in KONNEKT?**
   * Möglicherweise fehlen dem Benutzer die Berechtigungen für die Site. Testen Sie den Zugriff über das SharePoint-Webinterface.
   * Der Site-Typ stimmt möglicherweise nicht mit der KQL-Abfrage überein (z. B. werden persönliche OneDrive-Sites von der Standardabfrage nicht erkannt).

→ [Sites fehlen oder Ordner sind leer](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) | [Einige Sites oder Bibliotheken werden nicht angezeigt](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)

### Ordner sind leer

1. **Alle Bibliotheken leer?**
   * Möglicherweise wurde keine Administratoreinwilligung erteilt oder die API-Berechtigungen sind unvollständig.
   * → [Mandantenweite Administratoreinwilligung gewähren](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
   * → [Leere Bibliotheken](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries)
2. **Bestimmte Bibliothek leer?**
   * Möglicherweise hat der Benutzer keine Berechtigung für den Inhalt der Bibliothek. Prüfen Sie die SharePoint-Berechtigungen.
   * Die Bibliothek kann tatsächlich leer sein.
3. **Zeigt eine verwaltete Zuordnung einen leeren Ordner an?**
   * Die Site-URL in der Richtlinie ist möglicherweise falsch. Überprüfen Sie sie, indem Sie die URL in einem Browser öffnen.

→ [Leere Bibliotheken](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries) | [Sites fehlen oder Ordner sind leer](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty)

### Authentifizierungsfehler

1. **"Zugriffstoken konnte nicht abgerufen werden"**
   * → [Probleme mit dem Zugriffstoken](https://docs.konnekt.io/troubleshooting/access-token-issues)
2. **MFA-Abfrage-Schleife (wiederholte MFA-Aufforderungen)**
   * Konflikt mit Conditional Access-Richtlinie oder Problem mit dem WAM-Broker.
   * → [Conditional Access](https://docs.konnekt.io/installation/security/conditional-access)
3. **Falsches Konto angemeldet**
   * Rechtsklick auf das Symbol im Infobereich → **Konten** → das falsche Konto entfernen → das richtige hinzufügen.
4. **"Admin-Genehmigung erforderlich"**
   * → [Mandantenweite Administratoreinwilligung gewähren](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)

→ [Probleme mit dem Zugriffstoken](https://docs.konnekt.io/troubleshooting/access-token-issues)

### Dateioperationsfehler

1. **Upload fehlgeschlagen**
   * Details zum Fehler über das Symbol im Infobereich prüfen → **Fehler**.
   * Netzwerkkonnektivität überprüfen.
   * Prüfen Sie, ob SharePoint-Drosselung auftritt (achten Sie auf HTTP 429 in den Debugprotokollen). Wenn Sie Drosselung oder Backend-Fehler sehen, [mit Graph Explorer reproduzieren](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) um Probleme auf Microsoft-Seite zu bestätigen.
   * → [So gehen Sie mit Fehler(n) um](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)
2. **Datei gesperrt / unerwartet schreibgeschützt**
   * Ein anderer Benutzer hat die Datei möglicherweise ohne aktivierte gemeinsame Bearbeitung geöffnet.
   * Die Datei kann den Nur-Lese-Größenschwellenwert überschreiten. → [Beschränkungen für Dateigrößen beim Öffnen](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations)
3. **Zugriff verweigert**
   * Dem Benutzer fehlen Schreibberechtigungen in SharePoint. Über das Webinterface prüfen.
4. **"Pfad zu lang" oder Dateinamenfehler**
   * Pfad- und Dateinamenslänge mit den Grenzwerten abgleichen. → [Wie lang dürfen Pfad und Dateiname maximal sein?](https://docs.konnekt.io/troubleshooting/what-is-the-maximum-path-and-file-name-length)

→ [So gehen Sie mit Fehler(n) um](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)

### Öffnen von Office-Dateien schlägt fehl

1. **Office zeigt beim Öffnen eine Warnung an ("könnte Ihrem Computer schaden")**
   * Mark of the Web (MOTW) wird auf Dateien aus Netzwerkstandorten angewendet. → [Beim Öffnen von MS Office-Dokumenten wird eine Warnmeldung angezeigt](https://docs.konnekt.io/troubleshooting/opening-ms-office-documents-displays-a-warning-message)
   * Oft behoben, indem KONNEKT-Pfade zu vertrauenswürdigen Sites hinzugefügt werden. → [KONNEKT-Pfade als vertrauenswürdige Sites hinzufügen](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
2. **Doppelklicken auf eine Office-Datei bewirkt nichts oder Excel-Makrodateien lassen sich nicht öffnen**
   * KONNEKT-Pfade müssen sich in der Zone „vertrauenswürdige Sites“ befinden. → [KONNEKT-Pfade als vertrauenswürdige Sites hinzufügen](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
3. **KONNEKT stürzt beim Öffnen oder in der Vorschau von Office-Dateien ab**
   * Richtlinien zur Reduzierung der Angriffsfläche (ASR) blockieren KONNEKT möglicherweise. Schließen Sie aus `Konnekt.exe` und `KonnektStarter.exe` aus der ASR-Regel „Office Child Process“ aus. → [Riskante Aktion blockiert](https://docs.konnekt.io/troubleshooting/risky-action-blocked)
4. **Office zeigt eine veraltete Version einer Datei an**
   * → [Office zeigt veraltete Versionen an](https://docs.konnekt.io/troubleshooting/office-shows-outdated-versions)

### Leistungsprobleme

1. **Langsames Durchsuchen von Ordnern**
   * Anzahl der Elemente im Ordner prüfen (>1.000 Elemente verlangsamen das Durchsuchen).
   * Cache-Einstellungen prüfen - ein sehr niedriger TTL führt zu mehr API-Aufrufen.
   * Wenn die Langsamkeit mit Graph-API-429- oder 5xx-Fehlern im Debugprotokoll zusammenhängt, [mit Graph Explorer reproduzieren](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) mit Graph Explorer reproduzieren, um Drosselung oder Backend-Probleme zu bestätigen.
2. **Langsames Öffnen von Dateien**
   * Dateigröße und Netzwerkbandbreite prüfen.
   * Auf Drosselung prüfen (HTTP 429 in den Protokollen). Wenn vorhanden, [mit Graph Explorer reproduzieren](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).
3. **Unregelmäßige Langsamkeit (insbesondere morgens)**
   * Wahrscheinlich werden KONNEKT-Laufwerke von Antivirenprogrammen gescannt.
   * → [Langsame Leistung oder Fehler durch Antiviren-Scans verursacht](https://docs.konnekt.io/troubleshooting/slow-performance-or-errors-caused-by-antivirus-scanning)

### Andere Probleme

| Problem                                | Lösung                                                                                                                                                                                                                                                                  |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PDF-Vorschau defekt (Windows 11)       | → [PDF-Vorschau nach Windows 11-Update defekt](https://docs.konnekt.io/troubleshooting/pdf-preview-broken-after-windows-11-update)                                                                                                                                      |
| Graues X auf Dateien                   | Erwartetes Verhalten - KONNEKT markiert Dateien als `FILE_ATTRIBUTE_OFFLINE` um Bandbreite zu sparen. Kein Fehler. Siehe [Warum gibt es ein graues X oder einen braunen Koffer](https://docs.konnekt.io/troubleshooting/why-is-there-a-grey-x-on-my-files-and-folders). |
| Braune Koffer-Überlagerung auf Dateien | Datei ist für die Offlineverwendung markiert. Erwartetes Verhalten.                                                                                                                                                                                                     |
| KONNEKT-Symbol im Infobereich fehlt    | Starten Sie das Gerät neu. Wenn es weiterhin fehlt, installieren Sie KONNEKT neu.                                                                                                                                                                                       |
| Kann das Problem nicht beheben         | → [Debugprotokolle vorbereiten](https://docs.konnekt.io/troubleshooting/debug-log-preparation) und [den Support kontaktieren](https://docs.konnekt.io/support)                                                                                                          |

## Verwandte Seiten

* [Dateiprobleme mit Graph Explorer reproduzieren](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) - KONNEKT-Probleme von Microsoft 365-Backend-Problemen abgrenzen
* [Änderungsprotokoll](https://docs.konnekt.io/changelog) - aktuelle Fehlerbehebungen und behobene Probleme
* [Vorbereitung der Debugprotokolle](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - wie Protokolle für den Support gesammelt werden
* [Support](https://docs.konnekt.io/support) - wie Sie den KONNEKT-Support erreichen


---

# 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/de/troubleshooting.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.