Migrationsanleitungen für ISVs

Dieses Dokument unterstützt ISVs bei der Bereitstellung einer schnellen und zuverlässigen Migrationserfahrung für Kunden. Es enthält die neuesten Microsoft-Migrationspraktiken und Bedenken oder Fragen, die von ISVs aufgeworfen wurden.

Verwenden appbasierter Authentifizierung

Zwischen Endbenutzer-Datenverkehr und einer Anwendung, die Hintergrundaktivitäten wie eine Migration durchführt, gibt es unterschiedliche Verwendungsmuster. Es ist wichtig, den Benutzerdatenverkehr vom Anwendungsdatenverkehr zu unterscheiden.

Zur Bereitstellung einer stabilen Plattform und zuverlässigerer Dienste fordert Microsoft ISVs auf von der Verwendung einer benutzerbasierten Authentifizierung zur appbasierten Authentifizierung zu wechseln, um unseren Endbenutzern und Partnern eine höhere Zuverlässigkeit zu bieten.

Die Migration ist eine Aufgabe für eine Anwendung im Hintergrund und sollte nicht im Benutzermodus ausgeführt werden. Durch den Wechsel zu appbasierter Authentifizierung profitieren Sie von der flexiblen Kapazität außerhalb von Spitzenzeiten, um mehr Ressourcen zu haben.

Hinweis

Microsoft wird mit der Umsetzung der ordnungsgemäßen Nutzungsrollen im ersten Quartal 2020 beginnen. Lieferanten, die die Migration in Benutzerrollen fortsetzen, müssen mit zunehmender Drosselung und niedriger Leistung rechnen.

Weitere Informationen zum Registrieren einer App-ID und zum Implementieren appbasierter Authentifizierung erhalten Sie unter:

Anleitung zur Migration unter appbasierter Authentifizierung

Berechtigungseinstellungen

Azure Active Directory (AAD) bietet zwei Berechtigungsarten: delegierte Berechtigungen und Anwendungsberechtigungen. Die offizielle AAD-Anleitung finden Sie unter:

Bei SharePoint- und OneDrive-Migrationsszenarien lautet die Anweisung, die AAD-Berechtigungsvorgaben einzuhalten.

Für das Migrationstool, das von der Anmeldung und Anwesenheit des Endbenutzers abhängig ist, wird eine delegierte Berechtigung empfohlen.

Für ein dienstbasiertes Migrationstool, das ohne einen angemeldeten Benutzer ausgeführt wird, wie z. B. eine App, die als Hintergrunddienst ausgeführt wird, wird eine Anwendungsberechtigung empfohlen.

Anzahl der App-IDs

ISV haben Fragen vorgebracht, ob sie über eine einzige App-ID, die alle Produkte für die Migration abdeckt, oder über mehrere App-IDs je Software verfügen sollen. Es gibt keine speziellen Anweisungen für ISVs zum Identifizieren all ihrer App-IDs. Wenden Sie sich für Ausnahmeszenarios an Microsoft.

Hinweis

Registrieren Sie alle Ihre Migrations-App-IDs bei Microsoft, um sicherzustellen, dass Sie den angemessenen Durchsatz für Ihre Migrationsaufträge erhalten.

Verwenden der Migrations-API

Bei Migrationsaufträgen sollten Sie die vorhandene veröffentlichte Migrations-API verwenden.

Import-API (CreateMigrationJob)

CreateMigrationJob hilft ISVs, den Importvorgang nach SharePoint und OneDrive schneller und zuverlässiger zu machen.

Die neuesten unterstützten Features sind:

Export-API (asynchrones Lesen von Metadaten)

Eine neue Migrations-API, asynchrone Metadatenlese-API (Export-API) ist für ISVs verfügbar. Asynchrones Lesen von Metadaten unterstützt ISVs, Inhalte aus SharePoint und OneDrive mit schnellen und reduzierten Aufrufen zu exportieren. Beispielsweise kann die neue API alle Dateien exportieren und verwandte Metadaten aus der Stammebene der Dokumentbibliothek in einem einzigen Aufruf auflisten. Dadurch wird die Anzahl der erforderlichen Aufrufe herabgesetzt, die Wahrscheinlichkeit einer Drosselung reduziert und die Leistung verbessert.

Weitere Informationen erhalten Sie unter SharePoint-Migrationsexport-API (API für asynchrones Lesen von Metadaten)

Wechseln zur Microsoft Graph-API

Wenn ein Feature von der Migrations-API nicht unterstützt wird, empfehlen wir, dass Sie die Graph-API verwenden. Wenn die Graph-API das erforderliche Migrationsfeature nicht unterstützt, verwenden Sie CSOM. Allerdings erhöht die Verwendung von CSOM die Wahrscheinlichkeit einer Drosselung.

CSOM-Anleitung (nur als Ausweich-APIs)

Nachstehend finden Sie eine Anleitung zu bestimmten CSOM-Implementierungsszenarios, die die Migrationsleistung mit SharePoint und OneDrive verbessern.

Anleitung für das Sortieren von Enumerationsabfragen

Es gibt zwei Arten von Enumerationsabfragen, vorausgesetzt, der Kunde beabsichtigt, jedes Element ohne serverseitige Filterung zu lesen.

Um jedes Element auf der Liste rekursiv abzufragen – das heißt, dass die Reihenfolge nicht von dem/n Ordner(n) abhängt, in dem/denen die Elemente enthalten sind –, sollte die Abfrage nach ID sortieren.

<OrderBy Override="TRUE"><FieldRef name="ID"/></OrderBy>

Um jedes Element in einem bestimmten Ordner abzufragen, sollte die Abfrage anhand des Dateinamens FileLeafRef sortieren.

<OrderBy Override="TRUE"><FieldRef name="FileLeafRef"/></OrderBy>

Leitfaden zu Berechtigungen

Sie müssen sich bei der Planung der Migration zu OneDrive oder SharePoint dreier Schlüsselwerte bewusst sein, insbesondere, wenn Sie eine Hierarchie tief geschachtelter Ordner haben. Diese sind: (1) Anzahl der eindeutigen SharePoint-Berechtigungsbereiche, (2) Anzahl der Rollenzuweisungen und (3) die Gesamtzahl der Elemente in einer Liste oder Bibliothek. Lesen Sie den gesamten Leitfaden:

Für Migrationen über 100 TB

Für Kunden, die mehr als 100 TB an Daten migrieren, folgen Sie den Anweisungen zum Erstellen eines Supporttickets, das dem Produktteam beim Vorbereiten des Back-Ends für die Kunden hilft.

Eskalation und Drosselung

Der Hauptgrund für die Beeinträchtigung der Geschwindigkeit und das Auftreten einer Drosselung ist auf die Auslastung zurückzuführen, die durch das Aufrufen von CSOM- und REST-APIs generiert wird. Infolge dieser Last greifen Drosselungsregeln, die sich auf die Geschwindigkeit, Zuverlässigkeit und Prognostizierbarkeit der Migration auswirken. Die Drosselung wird zum Schutz der Datenbank und zum Sicherstellen einer guten Benutzererfahrung für unsere Kunden verwendet.

Die offizielle Drosselungsanleitung können Sie lesen unter:

Wir arbeiten weiterhin an der Ermittlung von Problemen und der Verbesserung der API. Die API für asynchrones Lesen von Metadaten ist ein direktes Ergebnis von ISV-Feedback. Wir schätzen Ihr Feedback als ISV bzw. Partner. Bei weiteren Fragen wenden Sie sich bitte an Microsoft.