Projekte, die den Dateiserver einfach nach SharePoint „kopieren und umstellen“ wollen, kommen meist zwei Wochen nach der Umstellung zurück: Fehler wegen Pfadlängen, Access-Datenbanken, die sich nicht öffnen, zerbrochene Excel-Verknüpfungen und Berechtigungen, bei denen niemand weiß, wer was sieht. Eine über Jahre gewachsene Freigabe wie \\FS01\Ortak hält Teamdokumente, persönliche Ordner, Anwendungsdaten und Archiv im selben Baum. Deshalb ist die Arbeit kein Kopiervorgang, sondern eine Neuklassifizierung der Daten. Im Folgenden beschreiben wir der Reihe nach, welche Daten nach SharePoint, welche nach OneDrive gehen, welche lokal bleiben und wie die Migration in der Praxis durchgeführt wird.
Erst die Bestandsaufnahme, dann der Plan
Ein Migrationsplan beginnt nicht mit der Freigabeliste, sondern mit einer Datenbestandsaufnahme. Ermitteln Sie für jede Freigabe: Gesamtgröße, Anzahl von Dateien und Ordnern, Verteilung nach letztem Änderungsdatum, tiefste Ordnerebene, längster Pfad, Dateitypen, Stellen mit unterbrochener NTFS-Vererbung und den Fachbereich, dem die Freigabe gehört. Eine Freigabe ohne Besitzer wird nicht migriert; zuerst wird der Besitzer ermittelt.
Das letzte Änderungsdatum ist die wichtigste Entscheidungsgrundlage. Daten, die seit Jahren niemand angefasst hat, in den aktiven Arbeitsbereich zu verschieben, verunreinigt die Suche und erhöht die Synchronisierungslast. Für diese Daten ist eine separate Archivwebsite oder ein schreibgeschütztes lokales Archiv meist die richtigere Adresse.
Migration Manager und das SharePoint Migration Tool (SPMT) erzeugen einen Scanbericht; eine erste Momentaufnahme mit PowerShell liefert jedoch schon vor der Installation des Werkzeugs die Zahlen für die Diskussion:
$wurzel = "\\FS01\Ortak"
Get-ChildItem -Path $wurzel -Recurse -File -ErrorAction SilentlyContinue |
Select-Object FullName, Length, LastWriteTime, Extension |
Export-Csv C:\Migration\ortak-bestand.csv -NoTypeInformation -Encoding UTF8
# Zusammenfassung nach Dateierweiterung
Import-Csv C:\Migration\ortak-bestand.csv |
Group-Object Extension |
Sort-Object Count -Descending |
Select-Object -First 20 Name, Count
Bei großen Freigaben läuft dieses Skript stundenlang und überspringt Ordner mit verweigertem Zugriff stillschweigend. Ein häufiger Fehler ist, die Bestandsaufnahme mit einem Konto ohne ausreichende Rechte zu erstellen, sodass die „fehlenden“ Ordner erst in der Umstellungsnacht auftauchen. Prüfen Sie vorab, dass das ausführende Konto Leserechte für den gesamten Baum hat.
Welche Daten wohin: SharePoint, OneDrive, Teams oder lokal
Die Regel ist einfach: Daten, die dem Team gehören und bleiben müssen, wenn ein Teammitglied geht, kommen nach SharePoint (meist in die verbundene Website eines Teams-Teams), die Arbeitsdateien einer einzelnen Person nach OneDrive. Benutzer-Basisordner (Home Drives) werden naturgemäß OneDrive zugeordnet.
| Datenart | Empfohlenes Ziel | Hinweis |
|---|---|---|
| Abteilungsfreigabe | SharePoint-Teamwebsite | Kann mit einem Teams-Team verbunden werden |
| Projektordner | Website oder Bibliothek je Projekt | Wird nach Projektende archiviert |
| Persönlicher Basisordner | OneDrive | Wird mit Known Folder Move zusammengeführt |
| Unternehmensweite Dokumente | Kommunikationswebsite | Die meisten Anwender lesen nur |
| Seit Jahren unveränderte Daten | Archivwebsite oder lokales Archiv | Bläht den aktiven Bereich nicht auf |
| Access-Datenbank, CAD, PST | Bleibt lokal oder eigene Lösung | Siehe Erläuterung unten |
Daten, die nicht migriert werden sollten
- Mehrbenutzer-Access-Datenbanken (.accdb, .mdb): Dateisperren und gleichzeitiges Schreiben funktionieren über SMB. Die Mehrbenutzernutzung über eine synchronisierte Bibliothek kann die Datei beschädigen.
- CAD-Projekte mit externen Referenzen: AutoCAD-Xrefs und Baugruppendateien hängen von absoluten oder relativen Pfaden ab. Ändert sich der Pfad, brechen die Referenzen. Für diese Daten eignet sich eine Lösung wie Azure Files, die SMB beibehält, besser.
- PST-Dateien: Microsoft unterstützt die Nutzung von PST-Dateien über Netzwerkfreigaben nicht; der Synchronisierungsclient kann geöffnete PST-Dateien nicht synchronisieren. PST-Dateien werden in das Exchange-Online-Archiv importiert.
- Anwendungsdatenordner: Daten, die ERP-, Buchhaltungs- und Lizenzserver in einer Freigabe ablegen, können nicht migriert werden, weil die Anwendung einen UNC-Pfad erwartet.
Ein Anwendungsordner gehört nicht nach SharePoint. Punkt.
Optionen für Daten, die SMB beibehalten müssen, behandeln wir gesondert im Ratgeber hybrider Dateiserver mit Azure Files und Azure File Sync.
Technische Grenzen: Pfadlänge, Zeichen, Dateitypen
Die Grenze, an der man in SharePoint und OneDrive am häufigsten scheitert, ist die Pfadlänge. Der aufgelöste Gesamtpfad (einschließlich Websiteadresse, Bibliothek, Ordnern und Dateiname) darf 400 Zeichen nicht überschreiten. Da das Präfix \\FS01\Ortak\... auf dem Dateiserver durch https://tenant.sharepoint.com/sites/Buchhaltung/Shared Documents/... ersetzt wird, kann ein Pfad, der lokal unproblematisch aussieht, im Ziel die Grenze überschreiten. Der Synchronisierungsclient legt die Dateien auf dem Datenträger des Anwenders unter C:\Users\benutzer\Firmenname\Website - Bibliothek\... ab; die Unterstützung langer Pfade durch ältere Windows-Anwendungen sorgt hier zusätzlich für Probleme.
# Lange Pfade unter Berücksichtigung des Zielpräfixes finden
$praefix = "https://tenant.sharepoint.com/sites/Buchhaltung/Shared Documents/"
Import-Csv C:\Migration\ortak-bestand.csv | ForEach-Object {
$relativ = $_.FullName.Substring("\\FS01\Ortak\".Length)
[pscustomobject]@{ Pfad = $_.FullName; ZielLaenge = ($praefix + $relativ).Length }
} | Where-Object ZielLaenge -gt 350 |
Export-Csv C:\Migration\lange-pfade.csv -NoTypeInformation -Encoding UTF8
Einen Schwellenwert von 350 statt 400 zu wählen, lässt Spielraum, falls der Website- oder Bibliotheksname später länger wird. Weitere Grenzen:
- In Datei- und Ordnernamen dürfen die Zeichen
" * : < > ? / \ |nicht verwendet werden; führende und nachgestellte Leerzeichen werden nicht akzeptiert. - Namen wie
.lock,CON,PRN,AUX,NUL,COM0–COM9,LPT0–LPT9,_vti_,desktop.inisowie Dateinamen, die mit~$beginnen, sind gesperrt. - Die Obergrenze für eine einzelne Datei beträgt 250 GB.
- Bibliotheken haben einen Listenansichtsschwellenwert von 5.000 Elementen; sollen viele Dateien in einem Ordner liegen, planen Sie Ansichten und indizierte Spalten im Voraus.
Die Grenzen werden im Lauf der Zeit aktualisiert. Prüfen Sie zu Projektbeginn erneut die Microsoft-Seite „Restrictions and limitations in OneDrive and SharePoint“.
Zuordnung von NTFS-Berechtigungen zu SharePoint-Berechtigungen
NTFS erlaubt es, die Vererbung auf jeder Ebene des Ordnerbaums zu unterbrechen; auf Dateiservern sammeln sich so über die Jahre Hunderte von Ausnahmen an. In SharePoint werden Berechtigungen auf Websiteebene vergeben: Besitzer, Mitglieder und Besucher. Ausnahmen auf Bibliotheksebene sind verwaltbar. Eindeutige (unique) Berechtigungen auf Ordner- und Dateiebene erschweren dagegen die Verwaltung und bringen die Bibliothek nahe an die von Microsoft empfohlene Höchstzahl eindeutiger Berechtigungen.
Die in der Praxis bewährte Reihenfolge der Zuordnung:
- Listen Sie in der Bestandsaufnahme alle Ordner mit unterbrochener Vererbung auf (in der Ausgabe von
Get-Acldiejenigen mitAreAccessRulesProtectedgleichTrue). - Entscheiden Sie mit dem Fachbereich, ob für jeden Unterordner mit eigener Zugriffsgruppe eine eigene Bibliothek oder eine eigene Website nötig ist. Der Ordner „Gehaltsabrechnung“ in der Buchhaltungsfreigabe sollte eine eigene Bibliothek oder eine eigene Website sein.
- Wandeln Sie in NTFS direkt an Benutzer vergebene Berechtigungen in Gruppen um. Im Ziel werden Entra-ID-Sicherheitsgruppen oder Microsoft-365-Gruppen verwendet; synchronisierte lokale AD-Gruppen können direkt genutzt werden.
- Kopieren Sie weit gefasste Berechtigungen wie „Jeder“ und „Domain Users“ nicht ins Ziel; definieren Sie sie über die Websitemitgliedschaft neu.
Migration Manager und SPMT bieten eine Option zum Beibehalten der Freigabeberechtigungen. Diese Option ordnet ACLs nur Identitäten zu, die im Ziel eine Entsprechung haben; ohne Zuordnungsdatei (User Mapping) werden lokale Konten und gelöschte SIDs nicht übernommen. Wie das Modell auf Website-, Bibliotheks- und Elementebene aufgebaut wird, beschreibt der Ratgeber Entwurf eines SharePoint-Berechtigungsmodells ausführlich.
Migration mit Migration Manager und SharePoint Migration Tool
Microsoft bietet für Dateifreigaben zwei kostenlose Werkzeuge. Die Wahl hängt vom Umfang ab:
| Kriterium | Migration Manager | SPMT |
|---|---|---|
| Verwaltung | SharePoint Admin Center | Desktopanwendung |
| Skalierung | Mehrere Agents, parallele Aufgaben | Ein einzelner Rechner |
| Geeignetes Szenario | Große Migration mit vielen Freigaben | Kleine oder einmalige Migration |
| Aufgabeneingabe | Portal oder Massen-CSV | Oberfläche, CSV/JSON oder PowerShell |
Bei Migration Manager werden die Agents auf Windows-Rechnern in der lokalen Serverinfrastruktur installiert, die Netzwerkzugriff auf den Dateiserver haben; die Aufgaben werden aus dem Admin Center verteilt. Installieren Sie den Agent nicht auf dem Dateiserver selbst, sondern auf einem separaten Server im selben Netzwerk. So konkurriert die Kopierlast nicht mit den Dateien, die Anwender öffnen.
Empfohlener Ablauf
- Scan: Führen Sie alle Quellen zunächst nur im Scanmodus aus. Der Bericht zeigt lange Pfade, ungültige Zeichen und nicht zugängliche Dateien.
- Korrektur: Kürzen Sie Pfade, korrigieren Sie Namen, löschen Sie unnötige Daten oder verschieben Sie sie ins Archiv.
- Erste Kopie: Erstellen Sie die vollständige Kopie, während die Anwender auf dem Dateiserver arbeiten.
- Inkrementelle Durchläufe: Ein erneuter Lauf derselben Aufgabe überträgt nur neue oder geänderte Dateien.
- Umstellung: Die Freigabe wird schreibgeschützt gesetzt, der letzte inkrementelle Durchlauf läuft, die Anwender werden zum neuen Speicherort geleitet.
Die Liste fehlgeschlagener Elemente in den Aufgabenberichten muss vor der Umstellung auf null gebracht oder jeder Eintrag bewusst ausgeschlossen werden. Die Migrationsdauer hängt von der Dateianzahl, der durchschnittlichen Dateigröße und der Drosselung (Throttling) auf Tenant-Seite ab. Nennen Sie die Dauer nicht geschätzt, sondern messen Sie sie an einer Pilotfreigabe und rechnen Sie sie auf die verbleibenden Daten hoch. Kleine Dateien werden langsam übertragen.
OneDrive-Synchronisierungsclient und Umstellung der Anwender
Das gewohnte Erlebnis eines Laufwerksbuchstabens bietet der OneDrive-Synchronisierungsclient; der Client skaliert jedoch nicht unbegrenzt. Microsoft empfiehlt, insgesamt 300.000 Dateien über alle synchronisierten Bibliotheken nicht zu überschreiten. Alle Abteilungswebsites für alle zu synchronisieren, überschreitet diese Grenze schnell; Beschwerden über hohe CPU- und Datenträgerlast bei der Anmeldung landen in der ersten Woche beim Support.
- Files On-Demand muss aktiviert sein; eine Datei wird erst beim Öffnen heruntergeladen.
- Statt die ganze Bibliothek synchronisieren zu lassen, lassen Sie Anwender nur die benötigten Ordner über „Verknüpfung zu OneDrive hinzufügen“ in ihr OneDrive aufnehmen.
- Leiten Sie mit Known Folder Move die Ordner Desktop, Dokumente und Bilder über Intune oder Gruppenrichtlinien nach OneDrive um. Legt man dies in denselben Zeitraum wie die Migration der Basisordner, erlebt der Anwender nur eine einzige Änderung.
- Bereiten Sie Gruppenrichtlinien-Einstellungen und Anmeldeskripte, die alte Laufwerkszuordnungen entfernen, vor dem Umstellungstag vor.
Die Datensicherung nach der Migration ist eine eigene Entscheidung. Versionsverlauf und Papierkorb von SharePoint ersetzen keine Sicherung; ausführlich dazu im Ratgeber Microsoft-365-Datensicherung.
Checkliste für den Umstellungstag
- Der Scanbericht ist für alle Freigaben sauber; fehlgeschlagene Elemente sind null oder bewusst ausgeschlossen.
- Besitzer, Mitglieder und Besucher der Zielwebsites sind mit dem Fachbereich abgestimmt.
- Die Quellfreigaben sind auf NTFS-Ebene schreibgeschützt (nicht nur die Freigabeberechtigung, auch die NTFS-Schreibberechtigung ist entfernt). Wer nur die Freigabeberechtigung sperrt, hindert niemanden, der sich per RDP mit dem Server verbindet, am Schreiben.
- Der letzte inkrementelle Durchlauf ist abgeschlossen, die Dateianzahlen in Quelle und Ziel sind verglichen.
- Laufwerkszuordnungen sind entfernt; OneDrive-Verknüpfungen und Teams-Kanäle sind den Anwendern bekannt gegeben.
- Das Supportteam hat einen Hinweis zu UNC-Verknüpfungen innerhalb von Anwendungen erhalten (verknüpfte Excel-Arbeitsmappen, Makros, Verknüpfungen).
- Der Zeitraum, in dem der alte Server schreibgeschützt bleibt, und das Abschaltdatum sind festgelegt; vor dem Abschalten wurde eine letzte Vollsicherung erstellt.
In Umgebungen mit DFS Namespace lässt sich die Umstellung leichter steuern: Die Namespace-Ziele werden geändert und die Anwender umgeleitet. Bewerten Sie die vorhandene Struktur anhand der Kriterien im Beitrag Entwurf von DFS Namespace und DFS Replication. Wenn Sie bei Datenklassifizierung und Berechtigungsentwurf Unterstützung wünschen, besuchen Sie unsere Seite Microsoft 365 und Cloud-Dienste. Für den aktuellen Funktionsumfang der Werkzeuge ist die Dokumentation des SharePoint Migration Tool von Microsoft maßgeblich. Für Dokumentklassifizierung, Revisionen und Zugriffsordnung nach der Migration siehe unseren Dienst Einrichtung des SharePoint-Dokumentenmanagements.
Häufig gestellte Fragen
Ist es richtig, den gesamten Dateiserver in eine einzige SharePoint-Website zu verschieben?
Nein. Eine einzige Website mit einer einzigen Bibliothek führt zu zerbrochenen Berechtigungen, einem überlasteten Synchronisierungsclient und dem Erreichen von Ansichtsschwellenwerten. Die Freigaben nach Besitz und Zugriffsgruppe auf separate Websites und Bibliotheken aufzuteilen, erleichtert die Verwaltung.
Können Anwender den Dateiserver während der Migration weiter nutzen?
Ja. Die erste vollständige Kopie kann erstellt werden, während die Anwender arbeiten. Inkrementelle Durchläufe vor der Umstellung übertragen nur geänderte Dateien; in der Umstellungsnacht wird die Freigabe schreibgeschützt gesetzt und der letzte inkrementelle Durchlauf ausgeführt.
Sollten NTFS-Berechtigungen eins zu eins nach SharePoint übernommen werden?
Die Werkzeuge bieten eine Option zum Beibehalten von Berechtigungen, doch tief verschachtelte und auf Elementebene unterbrochene Berechtigungen unverändert zu übernehmen, hinterlässt in SharePoint eine unverwaltbare Struktur. Berechtigungen auf Website- und Bibliotheksebene gruppenbasiert neu zu entwerfen und Ausnahmen in eigene Bibliotheken zu verlagern, ist nachhaltiger.
Wann sollte der alte Dateiserver nach der Migration abgeschaltet werden?
Nachdem die Freigaben schreibgeschützt gesetzt wurden, sollten sie noch eine Zeit lang erreichbar bleiben; Zugriffe und Anwendungsabhängigkeiten werden beobachtet, danach wird eine letzte Sicherung erstellt und der Server abgeschaltet. Diesen Zeitraum vorab mit den Fachbereichen zu vereinbaren, vermeidet Überraschungen.