Defekte Links nach SharePoint Tenant-zu-Tenant-Migration reparieren

Tenant-zu-Tenant-Migrationen gehören zu den komplexesten SharePoint-Szenarien — sie ändern sowohl die Basis-URL als auch die internen Element-IDs von SharePoint und zerstören dadurch jeden eingebetteten Link in jedem Office-Dokument. Dieser Leitfaden erklärt, was defekt wird, warum und wie ReplaceMagic alle drei Link-Typen in großem Maßstab repariert.

Tenant-Migrationen beschädigen ALLE drei Link-Typen: absolute URL-Links, relative Pfad-Links UND SharePoint ID-basierte Links
Manuelle Reparatur ist im Unternehmensmaßstab nicht möglich — schon 1.000 Dokumente mit je 10 Links ergeben 10.000 manuelle Bearbeitungen
ReplaceMagic verarbeitet alle drei Link-Typen automatisch, einschließlich der Konvertierung ID-basierter Links (auf Basis benutzerdefinierter Suchen/Ersetzen-Kombinationen)

Warum Tenant-zu-Tenant-Migrationen Dokument-Links zerstören

Wenn ein Unternehmen von einem Microsoft 365-Tenant zu einem anderen wechselt — aufgrund einer Übernahme, Fusion oder Ausgliederung — ändern sich alle SharePoint-URLs, da sich die Tenant-Domäne ändert (company.sharepoint.com wird zu newcompany.sharepoint.com). Zusätzlich hat jedes SharePoint-Element eine interne ID, die für diesen Tenant eindeutig ist — diese IDs werden nicht in den neuen Tenant übertragen. Das Ergebnis ist, dass jeder eingebettete Link in jedem Dokument zum Zeitpunkt der Umstellung defekt ist.

1. Absolute URL-Links

Diese verweisen direkt auf die alte Tenant-Domäne (z. B. https://oldcompany.sharepoint.com/sites/Finance/...). Nach der Migration ist die Domäne ungültig. Lösung: Alte Domäne durch neue Domäne in allen Dokumenten ersetzen.

2. Relative Pfad-Links

Diese verweisen auf Dokumente über relative Pfade innerhalb der SharePoint-Site-Hierarchie. Sie können defekt werden, wenn sich die Site-Struktur während der Migration ändert. Lösung: Die geänderten Pfadkomponenten aktualisieren.

3. ID-basierte Links (am kritischsten)

SharePoint speichert einige Links als Verweise auf die interne Datenbank-ID des Elements (z. B. /sites/Finance/_layouts/15/Doc.aspx?sourcedoc={GUID}). Diese GUIDs sind tenant-spezifisch und existieren im Ziel-Tenant nicht. Nach der Migration verweisen diese Links auf nichts. Lösung: ReplaceMagic konvertiert ID-basierte Links in korrekte URL-basierte Links, basierend auf benutzerseitig bereitgestellten Suchen/Ersetzen-Kombinationen, vor oder nach der Migration, sodass sie im neuen Tenant funktionsfähig bleiben.

Alle Änderungen – basierend auf benutzerseitig bereitgestellten Suchen/Ersetzen-Regeln

ReplaceMagic führt alle Änderungen auf Basis von Suchen/Ersetzen-Regeln durch, die vom Benutzer bereitgestellt werden. ReplaceMagic.SmartMapper automatisiert die Erstellung dieser Regeln — er löst SharePoint DocIDs auf und generiert die erforderlichen Muster direkt aus Ihrer Quell → Ziel-Zuordnung, vor dem Tenant-Umstellungszeitpunkt. Weitere Details finden Sie im SmartMapper-Leitfaden.

Wie ReplaceMagic alle drei Link-Typen repariert

Schritt 1 — Vor-Migrations-Scan

Führen Sie ReplaceMagic gegen den Quell-Tenant aus, um ein vollständiges Inventar aller Dokumente und aller Link-Typen zu erstellen. Ermitteln Sie, wie viele absolute, relative und ID-basierte Links vorhanden sind. Dieses Inventar fließt direkt in Ihre Ersetzungsregeln ein und bildet eine Grundlage für die Nachmigrationsprüfung.

Schritt 2 — Ersetzungsregeln konfigurieren

Richten Sie die Domänen-Ersetzung ein (alte URL → neue URL). Für ID-basierte Links kann ReplaceMagic diese auf Basis benutzerseitig bereitgestellter Suchen/Ersetzen-Regeln konvertieren. Alle Regeltypen werden in einer einzigen Import-Datei konfiguriert und in einem einzigen Verarbeitungsdurchlauf ausgeführt.

Schritt 3 — Vorschau und Validierung

Führen Sie den Vorschaumodus aus, um alle vorgeschlagenen Änderungen vor der Bestätigung zu sehen. Überprüfen Sie, ob die Ersetzungsregeln alle beim Scan gefundenen Link-Varianten abdecken. Passen Sie die Regeln an, falls Sonderfälle identifiziert werden.

Schritt 4 — Ausführen

Führen Sie die Ersetzung aus. ReplaceMagic verarbeitet alle Dokumente parallel und aktualisiert alle drei Link-Typen in einem Durchlauf, ohne eine Datei zu öffnen. SharePoint-Metadaten (Datum der letzten Änderung, Autor) bleiben erhalten, wenn mit Site-Admin-Rechten ausgeführt wird.

Schritt 5 — Nachmigrationsprüfung

Scannen Sie den Ziel-Tenant erneut, um zu bestätigen, dass alle Links nun korrekt aufgelöst werden. Exportieren Sie einen Prüfbericht für die Projektabnahme und die Revisionsdokumentation.

Was das Ersetzungs-Vorbereitungspaket leistet

Für komplexe Tenant-zu-Tenant-Migrationen mit Hunderten von Pfadvarianten oder großen Mengen ID-basierter Links kann das ReplaceMagic-Team alle Ersetzungs-Zeichenkettenkombinationen in Ihrem Auftrag vorbereiten. Dieser Service analysiert Ihren Quell-Tenant, identifiziert jedes eindeutige Link-Muster und liefert eine sofort importierbare Ersetzungsregeldatei. Details finden Sie im Ersetzungs-Vorbereitungspaket.

Wichtige Hinweise

Zeitpunkt: ReplaceMagic sollte idealerweise NACH der Migration aller Dokumente in den Ziel-Tenant ausgeführt werden
Berechtigungen: Site-Admin-Rechte auf dem Ziel-SharePoint-Tenant sind erforderlich, um das Datum der letzten Änderung zu erhalten
ID-basierte Links: Die Konvertierung sollte vor der vollständigen Ausführung anhand einer Stichprobe validiert werden
Umfang: Microsoft Teams und OneDrive for Business-Dokumente werden abgedeckt (SharePoint-Backend)

Kostenlose Testversion herunterladen Ersetzungs-Vorbereitungspaket

Verwandte Leitfäden: