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 Prozess-status und Protokollen 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

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.

Create 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 sie die Migrations-API, um die Migration zu starten und 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 die 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 die Workload zum SPO-Back-End anders generiert als der vom Endbenutzer generierte 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.

Ziel-SPO-Website 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 SPO-Zielstandorten.

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 Online-Infrastruktur zu schützen. Vermeiden Sie eine Drosselung, indem Sie die Drosselungsanleitung befolgen.

Spezielle Themen

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 SPMT-Webpart-Serialisierungs-DLL, um Webparts zu SharePoint zu migrieren. Anweisungen finden Sie unter Migrieren von Webparts .