Microsoft SharePoint und OneDrive unterliegen bestimmten Einschränkungen hinsichtlich Dateinamen, Sonderzeichen, Dateitypen und Pfadlängen. Die Einhaltung dieser Regeln ist entscheidend, um Synchronisierungsfehler, Upload-Probleme und Datenverluste zu vermeiden. Dieser Artikel gibt Ihnen eine vollständige Übersicht aller Einschränkungen.
Die folgenden Zeichen dürfen nicht in Datei- oder Ordnernamen verwendet werden:
| Zeichen | Bezeichnung |
|---|---|
" | Anführungszeichen |
* | Sternchen (Wildcard) |
: | Doppelpunkt |
< | Spitze Klammer auf |
> | Spitze Klammer zu |
? | Fragezeichen |
/ | Schrägstrich |
\ | Rückwärts-Schrägstrich (Backslash) |
| | Pipe-Zeichen |
⚠️ Zusätzliche Hinweise:
# und % noch nicht unterstützt. Der SharePoint-Admin kann dies aktivieren.&-Zeichen nicht erlaubt.; (Semikolon) im Ordnernamen das Speichern verhindern.Die folgenden Namen sind vollständig blockiert und können nicht für Dateien oder Ordner verwendet werden:
| Blockierter Name | Hinweis |
|---|---|
.lock | Sperrdatei |
CON | Reservierter Windows-Gerätename |
PRN | Reservierter Windows-Gerätename |
AUX | Reservierter Windows-Gerätename |
NUL | Reservierter Windows-Gerätename |
COM0 – COM9 | Reservierte serielle Schnittstellen |
LPT0 – LPT9 | Reservierte Druckeranschlüsse |
_vti_ | Darf nirgends im Dateinamen erscheinen |
desktop.ini | Windows-Systemdatei |
Dateinamen mit ~$ am Anfang | Temporäre Office-Dateien |
🚨 Sonderfälle:
~) beginnen.Neben den verbotenen Zeichen gibt es auch Regeln zur Position bestimmter Zeichen in Dateinamen:
| Regel | Beschreibung |
|---|---|
Kein . am Anfang | Dateinamen dürfen nicht mit einem Punkt beginnen |
Kein . am Ende | Dateinamen dürfen nicht mit einem Punkt enden |
Keine aufeinanderfolgenden .. | Mehrere aufeinanderfolgende Punkte in der Mitte sind nicht erlaubt |
_ am Anfang | Macht die Datei/den Ordner zu einer versteckten Datei |
Die Gesamtlänge des Dateipfads wird aus mehreren Teilen zusammengesetzt:
SharePoint-URL + Bibliotheksname + Ordnerstruktur + Dateiname = Gesamtpfad
| Beschränkung | Maximale Länge |
|---|---|
| Gesamter URL-Pfad (SharePoint Online / OneDrive) | 400 Zeichen |
| Lokaler Pfad bei Windows-Synchronisation | 256 Zeichen |
⚠️ Häufige Fehlerursache: Zu lange Pfade sind eine der häufigsten Ursachen für Synchronisierungsfehler. Achten Sie besonders auf tiefe Ordnerverschachtelungen und lange Bibliotheksnamen, da diese direkt Teil der URL sind. Leerzeichen werden in URLs als %20 kodiert – ein Zeichen wird so zu drei Zeichen im Pfad.
| Dateityp | Verhalten |
|---|---|
.tmp — Temporäre Dateien | Werden nicht synchronisiert |
desktop.ini (Windows) | Werden nicht synchronisiert |
.ds_store (macOS) | Werden nicht synchronisiert |
.pst — Outlook-Datendateien | Werden seltener synchronisiert, um Netzwerkverkehr zu reduzieren |
Ausführbare Dateien (.exe, .aspx u. a.) | Aus Sicherheitsgründen blockiert (je nach Admin-Konfiguration) |
Die Liste blockierter Dateitypen kann je nach Organisation variieren, da der SharePoint-Administrator zusätzliche Dateitypen sperren oder freigeben kann.
| Beschränkung | Limit |
|---|---|
| Maximale Dateigröße pro Einzeldatei | 250 GB |
Für Dateien, die größer als einige GB sind, empfiehlt Microsoft die Nutzung des OneDrive-Synchronisierungsclients anstelle des Browser-Uploads.
| Limit | Wert |
|---|---|
| Maximale Elemente pro Bibliothek | 30 Millionen |
| Empfohlene Sync-Menge (alle Bibliotheken) | max. 300.000 Dateien |
| Listenansicht-Schwellenwert | 5.000 Elemente pro Ansicht |
| Max. Elemente pro freigegebenem Ordner | 50.000 |
| Empfohlene eindeutige Berechtigungen | max. 5.000 (Hard-Limit: 50.000) |
Das SharePoint-Migrationstool (SPMT) ist ein kostenloses Microsoft-Tool zur Migration von Inhalten nach SharePoint Online, OneDrive und Microsoft Teams. Es hilft insbesondere dabei, unzulässige Inhalte bereits vor der Migration zu erkennen und zu beheben.
SPMT bietet einen reinen Scan-Modus („Nur Scan durchführen"), mit dem Sie Ihre Dateien vor der eigentlichen Migration prüfen können:
| Erkanntes Problem | Beschreibung |
|---|---|
| Ungültige Dateinamen | Dateien mit unzulässigen Zeichen |
| Zu lange Pfade | Dateipfade, die das 400-Zeichen-Limit überschreiten |
| Reservierte Dateinamen | Dateien wie CON, PRN, desktop.ini usw. |
| Blockierte Dateitypen | Dateien, die von SharePoint Online nicht akzeptiert werden |
| Nicht ausreichend Speicherplatz | Wenn der Arbeitsordner für die Migration zu klein ist |
| Doppelte Einträge | Doppelte Zeilen in der CSV-Datei bei Massenmigration |
| Einstellung | Beschreibung |
|---|---|
| Nur Scan durchführen | Dateien werden geprüft, aber nicht migriert – ideal zur Vorab-Bewertung |
| Automatisch starten bei Scan ohne Fehler | Migration startet automatisch, wenn keine Probleme gefunden werden |
| SharePoint-Berechtigungen beibehalten | Berechtigungen der Quelldateien werden migriert |
| Dateiversionsverlauf migrieren | Alle oder eine bestimmte Anzahl von Versionen migrieren |
| Ausgeblendete Dateien einschließen | Steuert, ob versteckte Systemdateien migriert werden |
%20 dargestellt und verlängern den Pfad.🔍 Warum werden meine Dateien nicht synchronisiert?
Häufigste Ursachen sind ungültige Zeichen im Dateinamen, zu lange Dateipfade oder blockierte Dateitypen. Prüfen Sie die oben genannten Einschränkungen und korrigieren Sie die betroffenen Dateien.
🔧 Wie finde ich problematische Dateien vor einer Migration?
Nutzen Sie den Scan-Modus des SPMT (Einstellung: „Nur Scan durchführen") oder das SharePoint Migration Assessment Tool (SMAT) für SharePoint Server-Umgebungen. Beide Tools identifizieren ungültige Dateinamen, zu lange Pfade und blockierte Dateien.
📏 Wie berechne ich die tatsächliche Pfadlänge?
Die Pfadlänge setzt sich zusammen aus: https://tenant.sharepoint.com/sites/SiteName/LibraryName/Ordner/Dateiname.docx. Beachten Sie, dass Leerzeichen als %20 (3 Zeichen) und Umlaute als URL-kodierte Zeichen gezählt werden.
Siehe Artikel: Die Begrenzung der Pfadlänge in SharePoint Online - Das solltest du wissen!
💰 Ist das SharePoint-Migrationstool (SPMT) kostenlos?
Ja. Das SPMT wird von Microsoft kostenlos für alle Microsoft 365-Abonnenten bereitgestellt.
📅 Kann ich auch von lokalen Dateifreigaben migrieren?
Ja. Das SPMT unterstützt neben SharePoint Server auch die Migration von lokalen und Netzwerk-Dateifreigaben (File Shares) nach SharePoint Online, OneDrive und Microsoft Teams.