# Fehlerbehebung

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

## Bevor Sie beginnen

Wenn **mehrere Benutzer gleichzeitig dasselbe Problem melden**, oder wenn KONNEKT-Debug-Logs Graph-API-Fehler (HTTP 429, 500, 503, 504 oder `UnknownError`) anzeigen, kann die Ursache im Microsoft 365-Backend und nicht in KONNEKT liegen. 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 Sie: `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 wirkt erfolgreich, 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 benötigt einen Neustart, um seinen Kernelmodus-Treiber zu laden. Starten Sie neu und prüfen Sie erneut.
3. **Läuft der KONNEKT-Dienst?**
   * Prüfen Sie: `Get-Service -Name "Konnekt*"`
   * Läuft nicht → Dienst neu starten oder neu installieren.
4. **Ist der Benutzer angemeldet?**
   * Klicken Sie mit der rechten Maustaste auf das KONNEKT-Symbol im Infobereich → **Konten**. Wenn kein Konto aufgeführt ist, melden Sie sich an.
   * "Admin-Genehmigung erforderlich" → [Administratoreinwilligung tenantweit erteilen](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
5. **Laufwerk oder Freigabe ist sichtbar, aber ein Klick bewirkt nichts?**
   * → [Ein Klick auf eine Freigabe bewirkt nichts](https://docs.konnekt.io/troubleshooting/clicking-a-share-does-nothing)

### Sites oder Bibliotheken fehlen

1. **Wird Auto-Mapping verwendet?**
   * Prüfen Sie, dass `O365SharepointUsage = 1` in der Registrierung gesetzt ist.
   * Vergewissern Sie sich in der SharePoint-Weboberfläche, dass der Benutzer Zugriff auf die Site hat.
   * Prüfen Sie die KQL-Site-Abfrage – eine einschränkende Abfrage kann die Site ausschließen. Siehe [Auto-Mapping](https://docs.konnekt.io/configuration/mappings/auto-mapping).
   * Überprüfen Sie die Mitgliedschaft des Benutzers in Microsoft Entra ID-Gruppen, wenn Sites nach Gruppe gefiltert werden.
   * Site-Besitzer, aber kein Mitglied? Die KONNEKT-Ermittlung findet nur Sites, in 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. **Werden verwaltete Zuordnungen verwendet?**
   * Prüfen Sie, ob die `SharepointSites` Richtlinie angewendet ist: `gpresult /r` oder prüfen Sie die Registrierung.
   * Vergewissern Sie sich, dass die SharePoint-URL in der Richtlinie korrekt und erreichbar ist.
3. **Beim manuellen Hinzufügen einer Freigabe erscheint "Failed to open site: Key not found"?**
   * → [Freigabe hinzufügen: "Key not found"](https://docs.konnekt.io/troubleshooting/add-share-key-not-found)
4. **Site existiert in SharePoint, aber nicht in KONNEKT?**
   * Dem Benutzer fehlen möglicherweise Berechtigungen für die Site. Testen Sie den Zugriff über die SharePoint-Weboberfläche.
   * Der Site-Typ entspricht möglicherweise nicht der KQL-Abfrage (z. B. werden persönliche OneDrive-Sites von der Standardabfrage nicht erkannt).

→ [Fehlende Sites oder leere Ordner](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. **Sind alle Bibliotheken leer?**
   * Möglicherweise wurde die Administratoreinwilligung nicht erteilt oder die API-Berechtigungen sind unvollständig.
   * → [Administratoreinwilligung tenantweit erteilen](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?**
   * Dem Benutzer fehlen möglicherweise Berechtigungen 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) | [Fehlende Sites oder leere Ordner](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty)

### Authentifizierungsfehler

1. **"Failed to obtain access token"**
   * → [Probleme mit dem Zugriffstoken](https://docs.konnekt.io/troubleshooting/access-token-issues)
2. **MFA-Aufforderungsschleife (wiederholte MFA-Abfragen)**
   * Konflikt mit der 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 approval required"**
   * → [Administratoreinwilligung tenantweit erteilen](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)

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

### Fehler bei Dateioperationen

1. **Upload fehlgeschlagen**
   * Prüfen Sie die Fehlerdetails über das Symbol im Infobereich → **Fehler**.
   * Überprüfen Sie die Netzwerkverbindung.
   * Prüfen Sie, ob SharePoint-Drosselung auftritt (suchen Sie in den Debug-Logs nach HTTP 429). Wenn Sie Drosselung oder Backend-Fehler sehen, [mit Graph Explorer reproduzieren](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) um Microsoft-seitige Probleme zu bestätigen.
   * → [Wie man mit Fehler(n) umgeht](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)
2. **Datei gesperrt / unerwartet schreibgeschützt**
   * Möglicherweise hat ein anderer Benutzer die Datei geöffnet, ohne dass Co-Authoring aktiviert ist.
   * Die Datei kann die Schwelle für schreibgeschützte Größe überschreiten. → [Größenbeschränkungen beim Öffnen von Dateien](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations)
3. **Zugriff verweigert**
   * Dem Benutzer fehlen Schreibberechtigungen in SharePoint. Überprüfen Sie dies über die Weboberfläche.
4. **"Pfad zu lang" oder Dateinamensfehler**
   * Prüfen Sie die Länge von Pfad und Dateiname anhand der Limits. → [Wie lang dürfen Pfad und Dateiname maximal sein?](https://docs.konnekt.io/troubleshooting/what-is-the-maximum-path-and-file-name-length)

→ [Wie man mit Fehler(n) umgeht](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)

### Das Ö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 den 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. **Doppelklick 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 ab, wenn Office-Dateien geöffnet oder in der Vorschau angezeigt werden**
   * Regeln zur Einschränkung der Angriffsfläche (ASR) blockieren möglicherweise KONNEKT. Schließen Sie `Konnekt.exe` und `KonnektStarter.exe` von 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**
   * Prüfen Sie die Anzahl der Elemente im Ordner (>1.000 Elemente verlangsamen das Durchsuchen).
   * Prüfen Sie die Cache-Einstellungen – ein sehr niedriger TTL-Wert führt zu mehr API-Aufrufen.
   * Wenn die Langsamkeit in den Debug-Logs mit Graph-API-429- oder 5xx-Fehlern zusammenhängt, [mit Graph Explorer reproduzieren](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) um Drosselung oder Backend-Probleme zu bestätigen.
2. **Langsames Öffnen von Dateien**
   * Prüfen Sie Dateigröße und Netzwerkbandbreite.
   * Prüfen Sie auf Drosselung (HTTP 429 in den Logs). Falls vorhanden, [mit Graph Explorer reproduzieren](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).
3. **Wechselweise Langsamkeit (insbesondere morgens)**
   * Wahrscheinlich scannt die Antivirensoftware die KONNEKT-Laufwerke.
   * → [Langsame Leistung oder Fehler durch Antiviren-Scans verursacht](https://docs.konnekt.io/troubleshooting/slow-performance-or-errors-caused-by-antivirus-scanning)

### Weitere Probleme

| Problem                                | Lösung                                                                                                                                                                                                                                                                  |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PDF-Vorschau defekt (Windows 11)       | → [PDF-Vorschau nach einem 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. Falls es weiterhin fehlt, installieren Sie KONNEKT neu.                                                                                                                                                                                      |
| Problem kann nicht behoben werden      | → [Debug-Logs vorbereiten](https://docs.konnekt.io/troubleshooting/debug-log-preparation) und [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 trennen
* [Änderungsprotokoll](https://docs.konnekt.io/changelog) - aktuelle Korrekturen und behobene Probleme
* [Vorbereitung von Debug-Logs](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - wie Logs für den Support gesammelt werden
* [Support](https://docs.konnekt.io/support) - wie Sie den KONNEKT-Support erreichen


---

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