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

Dezember 2024

Wir haben ein Kontingent auf Elemente pro Benutzer freigeben für mich angewendet. Weitere Informationen finden Sie unter ShareWithMe-Ereigniskontingent .

November 2024

Wir haben die Protokollierung aller Ereignisse auf Dateiebene während der Migration aktiviert, z. B. das Löschen von Dateien, um die Überwachung zu unterstützen.

Juli 2024

Wir haben damit begonnen, HTTPS-Verbindungen mit von SharePoint bereitgestellten Azure Blob Storage Containern zu erzwingen, indem ein spr=https Feld in SAS-Token hinzugefügt wurde. Diese Durchsetzung wird 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 die ProvisionMigrationContainers -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 sie die Migrations-API, um die Migration zu starten und status

Die 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 die CreateMigrationEncrypted -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 mit der GetMigrationJobProgress-API nach.

Die Migrations-API generiert Protokolle im Manifestcontainer. Überprüfen Sie die Protokolleinträge auf Migrationsergebnisse.

Die Migrations-API generiert auch Protokolle von Aktivitäten auf Dateiebene, die von der Migration ausgeführt werden. Zu den unterstützten Aktivitäten auf Dateiebene gehören FileUploaded, FileDeleted, FileRenamed, FileMoved. Überprüfen Sie bei Bedarf M365 Admin Center auf Aktivitätsdetails.

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 Microsoft Graph-Authentifizierungsleitfaden.

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 der Anmeldung und Anwesenheit von Endbenutzern basieren, 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 und lese- und schreibzugriff ermöglichen, um die Produktivität zu erhalten. 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 .