SharePoint-Pfadlänge und Dateinamen: Beheben Sie die Probleme vor der Migration
Von Mirko Peters · · Aktualisiert
Die Grenze für die URL-Länge in SharePoint liegt bei 400 Zeichen für den decodierten Dateipfad. Finden Sie mit dieser Checkliste lange Pfade und ungültige Namen, bevor Sie migrieren.
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen
Die Grenze für die URL-Länge in SharePoint liegt bei 400 Zeichen für den decodierten Dateipfad einschließlich des Dateinamens. Alles, was länger ist, lässt sich nicht hochladen, kopieren oder synchronisieren, und die Benutzer erhalten eine Fehlermeldung statt der Datei. Diese Checkliste richtet sich an Verantwortliche einer SharePoint-Migration, die lange Pfade und ungültige Namen in der Quelle finden möchten, bevor die erste Kopie erfolgt. Denn das Umbenennen nach der Migration ist langsamer und riskanter. Sie erfahren, was Microsoft dokumentiert, was offenbleibt und wie Sie die längsten Pfade der Reihe nach beheben.
Das Wichtigste in Kürze
- Microsoft dokumentiert eine Grenze von 400 Zeichen für den gesamten decodierten Dateipfad einschließlich des Dateinamens bei OneDrive und SharePoint.
- Windows setzt eigene Grenzen: Office-Desktop-Apps können Dateien nicht öffnen, deren vollständiger Pfad mehr als 260 Zeichen umfasst, auch wenn die Cloud die Datei akzeptiert.
- Zu den ungültigen Zeichen zählen doppeltes Anführungszeichen, Sternchen, Doppelpunkt, spitze Klammern, Fragezeichen, Schrägstriche und senkrechter Strich. Führende und nachgestellte Leerzeichen sind ebenfalls nicht erlaubt.
- Die Quellen widersprechen sich, ob codierte oder decodierte Zeichen zählen, und auch beim Startpunkt der Zählung. Zählen Sie daher ab /sites und behalten Sie bei Ihren Prüfungen einen Sicherheitspuffer bei.
- Messen Sie die Pfade in der Quelle, kürzen Sie zuerst die längsten Pfade durch kürzere Ordnernamen und benennen Sie Dateien um, bevor Sie kopieren, nicht danach.
Grenze für die SharePoint-URL-Länge: Was Microsoft dokumentiert
Microsoft nennt die Grenze von 400 Zeichen für SharePoint Online an zwei Stellen. In der Dienstbeschreibung SharePoint-Grenzwerte heißt es, dass der gesamte decodierte Dateipfad einschließlich des Dateinamens bei OneDrive und SharePoint in Microsoft 365 nicht mehr als 400 Zeichen umfassen darf. Der Hilfeartikel What are the file path length limits? nennt dieselbe Zahl und ergänzt Details. Keine der beiden Seiten beschreibt eine Einstellung, mit der sich die Grenze erhöhen lässt. Planen Sie deshalb mit diesem Wert.
Die wichtigsten Punkte aus diesem Artikel:
- Jeder Ordner in der Hierarchie und der Dateiname samt Erweiterung zählen mit. Jedes Zeichen wird gezählt, einschließlich Trennzeichen, Leerzeichen und Erweiterung.
- Office für das Web verwendet dieselben 400 Zeichen.
- Sonderzeichen, Leerzeichen und Zeichen mit Akzenten werden in SharePoint URL-codiert. Ein Leerzeichen wird zu
%20.
Genau in diesem Punkt widersprechen sich die Seiten. Der Hilfeartikel sagt, codierte Formen zählen zur Grenze, doch seine Hauptregel bezieht sich auf den decodierten Pfad. Die Dienstbeschreibung erwähnt nur den decodierten Pfad. Der nächste Abschnitt zeigt, worin sich die Quellen sonst noch unterscheiden.
Wie SharePoint die Zeichen zählt
Drei Quellen beantworten die Frage nach der Zählweise, und sie stimmen nicht vollständig überein.
- Dekodiert oder kodiert? Eine akzeptierte Antwort in Microsoft Q&A, verfasst von externen Microsoft-Mitarbeitenden, besagt, dass die Pfadlänge auf dem dekodierten Pfad berechnet wird, und verweist auf den Artikel zu den Einschränkungen. Auch die Ankündigung von 2017 sagte dasselbe: Redmondmag zitiert Microsofts Bill Baer mit „There is no limit to encoded URLs in SharePoint Online and OneDrive for Business.“ Der Hinweis im Hilfeartikel, dass
%20mitzählt, ist die Ausnahme. - Wo beginnt die Zählung? Eine weitere Antwort in Microsoft Q&A von externen Microsoft-Mitarbeitenden besagt, dass die Zählung beim Segment
/sitesbeginnt und Abfrageparameter ignoriert werden. Bei einem Link wie/sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=...zählt nur der Teil vor dem Fragezeichen. Laut dieser Antwort zählen der Websitename und der Bibliotheksname mit. Das Beispiel im Hilfeartikel selbst beginnt jedoch an der Stammebene der Bibliothek. Behandeln Sie die Q&A-Antwort daher als Support-Hinweis, nicht als Dokumentation. - Und der Servername? Die Formel, über die Redmondmag 2017 berichtete, lautet: Protokoll plus Servername plus Ordner- oder Dateipfad plus Ordner- oder Dateiname plus Parameter. Das weicht von der Support-Antwort ab, und das ist ein weiterer Grund, nicht knapp zu rechnen.
Daraus ergibt sich eine sichere Regel. Zählen Sie ab /sites, berücksichtigen Sie den Websitenamen, den Bibliotheksnamen, jeden Ordner und den Dateinamen, und halten Sie einen Puffer von einigen Dutzend Zeichen, bis Sie einen realen Grenzfall in Ihrem Mandanten getestet haben.
Hat Microsoft das Pfadlimit erhöht?
Ja, einmal, laut Redmondmag. Im Mai 2017 berichtete der Artikel, dass Microsoft die maximale URL-Pfadlänge für SharePoint Online und OneDrive for Business von 256 auf 400 Unicode-Codeeinheiten erweitert hat. Seitdem liegt der Wert auf den oben zitierten Microsoft-Seiten bei 400. Wenn ein älterer Leitfaden oder ein Migrationstool noch 256 oder 260 nennt, beschreibt er das alte Limit oder das Windows-Limit, nicht das aktuelle Cloud-Limit.
Hyperlink-Spalten haben ein eigenes Limit von 255 Zeichen
Ein zweites Limit wird oft mit dem Pfadlimit verwechselt. In einer Microsoft-Q&A-Diskussion sagt eine Support-Antwort von Microsoft, dass die Hyperlink-Spalte in einer SharePoint-Liste oder -Bibliothek auf 255 Zeichen begrenzt ist und dies so beabsichtigt ist. Eine tief verschachtelte Ordnerstruktur kann leicht einen längeren Link erzeugen, weil der Link zu einer Datei jeden Ordnernamen wiederholt.
Als Workaround wird eine Spalte vom Typ „Mehrere Textzeilen“ mit erweitertem Rich-Text vorgeschlagen, in die der Link über die Hyperlink-Option des Editors eingefügt wird. Kommentierende in der Diskussion nennen zwei Nachteile: Der Link wird unter Umständen nicht aktualisiert, wenn die Zieldatei umbenannt oder verschoben wird, und die Option für erweiterten Rich-Text ist in Dokumentbibliotheken nicht verfügbar. Kürzere Ordnernamen lösen das Problem an der Wurzel.
Die Limits, die unter Windows zuschlagen
Ein Pfad kann in SharePoint unproblematisch sein und trotzdem auf dem Desktop scheitern. Der gleiche Hilfeartikel nennt die Windows-Seite:
- Office-Desktop-Apps können keine Dateien öffnen, deren vollständiger Pfad 260 Zeichen überschreitet, auch wenn die Datei lokal gespeichert ist.
- Der Datei-Explorer verwendet das 260-Zeichen-Limit zum Öffnen, Umbenennen und Verschieben von Dateien. Dabei greift er nicht auf die Windows-Richtlinie für lange Pfade zurück.
- Die OneDrive-Synchronisierung erlaubt einen lokalen Gesamtpfad von 520 Zeichen: einen lokalen Pfad von bis zu 400 Zeichen plus einen OneDrive-Stammordner von bis zu 120 Zeichen.
- Einzelne Datei- oder Ordnernamen dürfen im Datei-Explorer und im macOS-Finder bis zu 255 Zeichen lang sein.
Der lokale Pfad enthält den Ordner, in dem die synchronisierte Bibliothek liegt, und ist damit länger, als die meisten erwarten. Ein Pfad von 250 Zeichen in der Cloud kann auf dem Laptop eines Benutzers also 310 Zeichen lang sein. Behandeln Sie 260 als Arbeitslimit für alle Inhalte, die Benutzer aus synchronisierten Ordnern öffnen.
Namen, die SharePoint ablehnt
Die Länge ist nur die halbe Checkliste. Der Microsoft-Artikel Einschränkungen und Beschränkungen in OneDrive und SharePoint nennt, worauf Sie achten sollten:
- Ungültige Zeichen: Anführungszeichen, Sternchen, Doppelpunkt, Kleiner-als-Zeichen, Größer-als-Zeichen, Fragezeichen, Schrägstrich, umgekehrter Schrägstrich und senkrechter Strich.
- Leerzeichen: Führende und nachgestellte Leerzeichen sind nicht zulässig.
- Reservierte Namen: .lock, CON, PRN, AUX, NUL, COM0 bis COM9, LPT0 bis LPT9, _vti_ und desktop.ini.
- Präfix und Fragmente: Ein Dateiname, der mit
~$beginnt, ist nicht zulässig. Außerdem darf_vti_nirgendwo in einem Namen vorkommen. Der Nameformsist auf der obersten Ebene einer Bibliothek nicht zulässig. - Nummernzeichen und Prozentzeichen: Einige Organisationen unterstützen sie in Namen noch nicht. Globale Administratoren und SharePoint-Administratoren können sie aktivieren.
Diese Einschränkungen gelten für Dateien und Ordner. Ein Ordner mit einem nachgestellten Leerzeichen blockiert alles darunter. Ein einziger fehlerhafter Ordnername kann daher Tausende fehlgeschlagene Elemente verursachen.
Checkliste vor der Migration
Gehen Sie bei jeder Freigabe und jeder Website vor dem Kopieren in dieser Reihenfolge vor.
- Pfadlänge an der Quelle messen. Exportieren Sie eine Liste der vollständigen Pfade und berechnen Sie die Länge jedes Pfads. Bei einer Dateifreigabe liefert
Get-ChildItem -Recursein PowerShell den vollständigen Namen jedes Elements. Ein kurzes Skript kann die Zeichen zählen. - Zielpfad berechnen. Entfernen Sie den Teil des Quellpfads, der in der Bibliothek nicht existiert, und setzen Sie den neuen, bibliotheksrelativen Präfix davor. Zählen Sie ab
/sites, denn der Websitename und der Name der Dokumentbibliothek gehören zur Gesamtlänge. - Alles über 300 markieren. Das Limit von 400 ist die harte Grenze. Eine Markierung bei 300 lässt Raum für den Synchronisierungsordner und für spätere Umbenennungen.
- Ungültige Zeichen und reservierte Namen auflisten. Suchen Sie nach den oben genannten Zeichen, nach führenden und nachgestellten Leerzeichen sowie nach Namen wie Dateien mit
~$. - Nach Wirkung korrigieren. Kürzen Sie zuerst den Ordnernamen, der im langen Verzeichnisbaum am höchsten liegt. Ein kürzerer Ordnername verkürzt jeden Pfad darunter.
- Neu messen. Führen Sie dieselbe Zählung erneut durch. Erst danach planen Sie das Kopieren.
Auch die Migrationsprüfungen von Microsoft helfen. Migration Manager prüft jede Datei auf bekannte potenzielle Probleme. Das SharePoint-Migrationstool bietet eine Option, die nur prüft, sodass Sie Probleme erkennen, bevor Sie etwas verschieben. Nutzen Sie diese als zweite Kontrolle, nicht als einzige.
Beispiel: ein langer Pfad, zwei Grenzwerte
Dieses Beispiel verwendet erfundene Namen und Zahlen. Eine Datei liegt auf einer Dateifreigabe in einem Pfad von 247 Zeichen unterhalb des Freigabestamms, zum Beispiel 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/, gefolgt von einem Dateinamen mit 107 Zeichen. Das Ziel ist eine Bibliothek namens Projects. Um die Zahlen einfach zu halten, ignoriert das Beispiel den Websitenamen: Die Bibliothek fügt 9 Zeichen für Projects/ hinzu, und die Gesamtlänge beträgt 256.
- Cloud-Grenzwert: 256 liegt unter 400, daher akzeptiert SharePoint die Datei.
- Windows-Grenzwert: Ein typischer synchronisierter Pfad beginnt mit einem lokalen Ordner von 62 Zeichen, zum Beispiel
C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. Die lokale Gesamtlänge beträgt 62 + 247 = 309 und liegt damit über 260. Office-Desktopanwendungen können die Datei aus dem Synchronisierungsordner nicht öffnen.
Die Lösung besteht darin, Namen zu kürzen, nicht Grenzwerte zu erhöhen. Die Migrationsverantwortliche benennt die Ordner in Contracts, Northwind Phase 2, Tech Spec, Approved und Signed um und die Datei in Northwind Phase 2 - Tech Spec v3 signed.docx. Der Pfad unterhalb des Stamms sinkt damit von 247 auf 103 Zeichen. Die lokale Gesamtlänge sinkt von 309 auf 165 Zeichen. Das liegt deutlich unter 260 und lässt Raum für einen längeren Benutzernamen.
Prüfen Sie die fachliche Seite, bevor Sie umbenennen. Verträge und technische Spezifikationen folgen oft festen Namensregeln, und Dateinamen müssen aus rechtlichen Gründen unter Umständen unverändert bleiben. In diesem Fall kürzen Sie die Ordner und behalten die Dateinamen bei.
Optionen, wenn ein Pfad zu lang ist
Sie haben vier Möglichkeiten, in dieser Reihenfolge der Empfehlung:
- Ordnernamen kürzen. Das ist der günstigste Weg, die URL zu verkürzen, und er wirkt sich auf jede Datei darunter aus.
- Struktur vereinfachen. Entfernen Sie Ebenen, die nur Informationen wiederholen, etwa
Finalinnerhalb vonApproved. Die Anleitung von Microsoft zu Dateifreigaben empfiehlt außerdem, große Laufwerke in kleinere, stärker fokussierte Bibliotheken aufzuteilen. - Verwenden Sie Metadaten statt Ordnern. Eine Spalte wie Jahr oder Kunde in der Bibliothek ersetzt zwei Ordnerebenen.
- Lassen Sie veraltete Dateien zurück. Wenn sie seit Jahren niemand geöffnet hat, archivieren Sie sie an anderer Stelle.
Verlassen Sie sich nicht auf eine Umgehungslösung, etwa das Verschieben der Datei eine Ebene nach oben nach der Migration. Solange die Ursache nicht behoben ist, scheitert die nächste Umstrukturierung ebenfalls.
Stimmen Sie die Regeln mit den Inhaltsverantwortlichen ab, bevor Sie etwas umbenennen. Eine kurze Benennungskonvention, zum Beispiel höchstens 40 Zeichen pro Ordnername und höchstens 8 Ordnerebenen, gibt allen ein Ziel vor und verhindert, dass neue Inhalte nach der Migration wieder über die Grenzen geraten. Wiederholen Sie die Konvention in der Migrationsankündigung, damit die Nutzer verstehen, warum sich vertraute Ordnernamen geändert haben.
Häufige Fehler
- Von einem falschen Ausgangspunkt aus zählen. Der Pfad in der Quelle ist nicht der Pfad in der Bibliothek. Berechnen Sie den Zielpfad.
- Den lokalen Synchronisierungsordner vergessen. Ein Pfad, der im Browser funktioniert, kann in den Office-Desktop-Apps scheitern.
- Die Zählregeln ignorieren. Die Quellen widersprechen sich bei der Codierung und beim Ausgangspunkt, deshalb sollten Sie einen Puffer einplanen. Eine Migrationsanforderung, die wegen eines einzigen langen Elements fehlschlägt, kann die eigentliche Ursache zwischen vielen ähnlichen Fehlern verbergen.
- Namen nach dem Kopieren korrigieren. Umbenennungen in der Cloud werden auf alle Clients synchronisiert. Eine Umbenennung nach dem Verschieben wiederholt Arbeit, die Sie bereits an der Quelle hätten erledigen können.
- Sich auf eine einzige Prüfung verlassen. Führen Sie eigene Messungen und den Migrationsscan durch.
Wie Software helfen kann
PowerShell und eine Tabellenkalkulation reichen für den Einstieg: Listen Sie alle Pfade mit ihrer Länge auf, sortieren Sie nach Länge und gruppieren Sie nach oberster Ordnerebene. Die Migrationsscans von Microsoft liefern eine zweite Sicht. Einige Drittanbieter-Tools bieten ebenfalls Berichte zu Pfaden und Namen an. Bewerten Sie jedes Tool danach, ob es vom richtigen Ausgangspunkt aus zählt und die Dateien und Ordner anzeigt, die das Kopieren blockieren.
Nächster Schritt
Exportieren Sie diese Woche die Pfade einer Freigabe und sortieren Sie sie nach Länge. Notieren Sie dann, wie viele Dateien mehr als 300 Zeichen haben, denn diese Zahl bestimmt den Aufwand für Ihre Bereinigung im Hinblick auf das Längenlimit der SharePoint-URL.