Einführung in die SharePoint-Migrations-API
Die SharePoint-Migrations-API importiert Inhalte im großen Stil in SharePoint. Sie verarbeitet Inhalte und Manifestpakete als Aufträge in einer Warteschlange. Die API stellt den Prozessstatus und Protokolle bereit, sodass der Fortschritt der einzelnen Migrationsaufträge problemlos überwacht werden kann.
Verwenden Sie die Migrations-API, um Inhalte aus Dateifreigaben, SharePoint Server und anderen cloudbasierten Diensten zu migrieren.
Neuerungen
Juli 2024
Wir haben damit begonnen, eine HTTPS-Verbindung mit von SharePoint bereitgestellten Azure Blob Storage-Containern zu erzwingen, indem ein spr=https Feld in SAS-Token hinzugefügt wurde. Diese Durchsetzung ist am 21. Juli 2024 in vollem Umfang wirksam. Weitere Informationen finden Sie unter Verwenden von Azure Blob Storage-Containern und Azure-Warteschlangen mit der SharePoint-Migrations-API .
April 2024
Wir haben neue Felder in JobEnd Ereignissen hinzugefügt, um die Anzahl und bytes anzugeben, die für Dateien importiert wurden. Weitere Informationen finden Sie unter Migrationsereignisse in Azure-Warteschlange .
Januar 2024
Wir haben dieses Dokument neu formatiert, um Klarheit zu schaffen und Fehler zu korrigieren.
Übersicht über Migrationsschritte
Starten Sie einen Migrationsauftrag mit drei Schritten. Überprüfen Sie die Anleitungen in den einzelnen Schritten in diesem Abschnitt.
Bereitstellen der Zielcontainer und der Warteschlange
Verwenden Sie ProvisionMigrationContainers die -Methode, um die Container bereitzustellen. Weitere Informationen finden Sie unter Verwenden von Azure Blob Storage-Containern und Azure-Warteschlangen mit der Migrations-API . Sie können bei Bedarf auch eigene Container und Warteschlangen verwenden.
Vorbereiten des Inhalts
Packen Sie den Inhalt im definierten Format, und laden Sie sie als Inhaltspaket in Azure Blob Storage-Container hoch.
Überprüfen Sie Inhaltspaket , um die detaillierten Anforderungen anzuzeigen.
Erstellen der Manifestdateien
Erstellen Sie basierend auf dem Inhalt Manifestdateien im XML-Format, und laden Sie sie als Manifestpaket in Azure Blob Storage-Container hoch.
Überprüfen Sie Manifestdateien , um die detaillierten Anforderungen anzuzeigen.
Verwenden der Migrations-API zum Starten der Migration und Abrufen des Status
CreateMigrationJob -Methode erstellt einen Migrationsauftrag, der für die Verarbeitung in die Warteschlange eingereiht wird. Die Migrations-API verwaltet die Warteschlange und gibt Status und Protokolle zurück. Verwenden Sie CreateMigrationEncrypted die -Methode, um verschlüsselte Inhalte zu migrieren. Ausführliche Informationen finden Sie in der Referenz zur SharePoint-Migrations-API .
Beim Erstellen eines neuen Migrationsauftrags gibt die Migrations-API die Auftrags-ID zurück. Verfolgen Sie den Status des Imports bei Bedarf mit GetMigrationJobStatus der Methode nach, wobei die Azure-Warteschlange bereitgestellt wird.
Die Migrations-API generiert Protokolle im Manifestcontainer. Überprüfen Sie die Protokolleinträge auf Migrationsergebnisse.
Bewährte Methoden
Verwenden appbasierter Authentifizierung
Bei der Migration wird eine Workload zum SharePoint-Back-End anders generiert als vom Endbenutzer generierter Datenverkehr. Um Ressourcen mit unserer elastischen Funktion ordnungsgemäß zuzuordnen, verwenden Sie nur die App-basierte Authentifizierung in Ihrer Migrationslösung.
Verwenden Sie in Ihrer Migrationslösung nicht den Benutzermodus. Die Ausführung der Migration im Benutzermodus löst eine erhöhte Drosselung aus, was zu einer schlechten Leistung führt.
Weitere Informationen zum Registrieren einer App-ID und zum Implementieren der app-basierten Authentifizierung finden Sie unter Registrieren einer App-ID und Anleitung zur Microsoft Graph-Authentifizierung.
Microsoft Entra ID-Berechtigungen
Microsoft Entra ID bietet zwei Arten von Berechtigungen: Delegierte Berechtigung und Anwendungsberechtigungen. Weitere Informationen finden Sie unter Berechtigungen und Zustimmung im Azure Active Directory v1.0-Endpunkt .
Befolgen Sie für SharePoint- und OneDrive-Migrationsszenarien die Microsoft Entra ID-Berechtigungsspezifikation.
Verwenden Sie für Migrationstools, die auf angemeldeten Endbenutzern und anwesenheitsbasierten Endbenutzern basieren, die Delegierte Berechtigung.
Verwenden Sie für dienstbasierte Migrationstools, die ausgeführt werden, ohne dass ein angemeldeter Benutzer vorhanden ist, z. B. Anwendungen, die als Hintergrunddienste ausgeführt werden.
App-IDs
Sie können eine einzelne App-ID freigeben, um mehrere erstellte Migrationslösungen abzudecken, oder eine einzelne App-ID für jedes der Produkte erstellen. Stellen Sie sicher, dass Sie App-IDs registrieren. Die Freigabe von App-IDs wirkt sich nicht auf die Leistung oder Drosselung aus.
SharePoint-Zielwebsite nicht aktiviert lassen
Um Migrationsprobleme zu vermeiden, deaktivieren Sie die Zielwebsite für Benutzer bis zum Abschluss der Migration. Die Quelle könnte aktiv bleiben, sodass Lese- und Schreibzugriff die Produktivität erhalten bleibt. Wechseln Sie nach Abschluss der Migration zu den neuen SharePoint-Zielwebsites.
Leistung
Die Migrations-API verarbeitet Aufträge über einen Warteschlangenmechanismus mit vorkonfigurierten Workloadverwaltungseinstellungen. Die Migrations-API verarbeitet die Aufträge auf Der Grundlage der bestmöglichen Leistung, ohne Vereinbarung zum Servicelevel (SLA) oder garantierter Leistung.
Optimieren der Migrationsleistung
Um eine optimale Leistung für Ihre Migrationsprojekte zu gewährleisten, ist es wichtig, sorgfältig zu planen, insbesondere bei umfangreichen Migrationen. Weitere Informationen zum Schätzen von Zeitspannen und zum Optimieren der Leistung finden Sie in unserem Leistungsleitfaden.
Ich sehe Drosselungsmeldungen
Um eine gute Benutzererfahrung für alle Microsoft 365-Kunden zu gewährleisten, verwendet SharePoint die Drosselung, um die SharePoint-Infrastruktur zu schützen. Vermeiden Sie eine Drosselung, indem Sie die Drosselungsanleitung befolgen.
Spezielle Artikel
Migrieren von Freigabeereignissen von Dateien und Ordnern
Anweisungen zum Migrieren von Metadaten für freigegebene Ereignisse mit Dateien und Ordnern finden Sie im Artikel Freigabeereignisse .
Webparts
Verwenden Sie die Webpart-Serialisierungs-DLL des SharePoint-Migrationstools (SPMT), um Webparts zu SharePoint zu migrieren. Anweisungen finden Sie unter Migrieren von Webparts .