Freigeben über


Schritt 5: Identitätszuordnung (Vorschau)

Hinweis

Die mandantenübergreifende SharePoint-Migration befindet sich derzeit in einer privaten Vorschauphase der Entwicklung. Als nicht abgeschlossenes Projekt können sich alle Informationen oder Verfügbarkeiten jederzeit ändern. Der Support für Private Preview-Kunden wird per E-Mail abgewickelt. Die mandantenübergreifende SharePoint-Migration wird durch die Vorschaubedingungen der Microsoft Universal License Terms for Online Services abgedeckt.

Dies ist Schritt 5 in einer Lösung, die entwickelt wurde, um eine mandantenübergreifende SharePoint-Migration abzuschließen. Weitere Informationen finden Sie unter Übersicht über die mandantenübergreifende SharePoint-Migration.

Erstellen der Identitätszuordnungsdatei

In diesem Schritt des mandantenübergreifenden Migrationsprozesses erstellen Sie eine einzelne CSV-Datei (durch Trennzeichen getrennte Werte), die die Zuordnung der Benutzer und Gruppen auf dem Quellmandanten zu den entsprechenden Benutzern und Gruppen auf dem Zielmandanten enthält.

Es wird empfohlen, sich die Zeit zu nehmen, Ihre Zuordnungen zu überprüfen, um sicherzustellen, dass sie korrekt sind, bevor Sie mit der Migration zum Zielmandanten beginnen.

Die Identitätszuordnungsdatei enthält eine 1:1-Beziehung. Sie können denselben Benutzer nicht mehreren Benutzern im Zielmandanten zuordnen. Wenn Sie beispielsweise über Instanzen verfügen, in denen der Administrator der Besitzer mehrerer SharePoint-Konten ist, muss der Besitz so geändert werden, dass er dem entsprechenden Benutzer entspricht, den Sie von Quelle zu Ziel migrieren möchten. Ist dies nicht der Fall, werden diese Kontodateien nicht migriert.

Beispiel: In diesem Beispiel besitzt der Administrator mehrere SharePoint-Konten.

Besitzer des Quellmandanten Zielmandantenbenutzer
admin@source.com new.userA@target.com
admin@source.com new.userB@target.com
admin@source.com new.userC@target.com

Die mandantenübergreifende Migration unterstützt dieses Szenario:

Beispiel:

Besitzer des Quellmandanten Zielmandantenbenutzer
userA@source.com new.userA@target.com
userB@source.com new.userB@target.com
userC@source.com new.userC@target.com

Erstellen der CSV-Datei

In Ihrer CSV-Datei sind sechs Spalten erforderlich. Die ersten drei sind Ihre Quellwerte, die jeweils Details darüber liefern, wo sich Ihre Daten derzeit befinden. Die verbleibenden drei Spalten sind die entsprechenden Informationen zum Zielmandanten. Alle sechs Spalten müssen in der Datei berücksichtigt werden. Erstellen Sie Ihre Datei in Excel, und speichern Sie sie als .csv Datei.

Benutzer und Gruppen sind in derselben Datei enthalten. Je nachdem, ob es sich um einen Benutzer oder eine Gruppe handelt, ist die Angabe in der Spalte unterschiedlich. Geben Sie in jeder der Spalten Werte ein, wie in den Beispielen gezeigt. Fügen Sie KEINE Spaltenüberschriften ein.

Spalte Benutzer Gruppe Microsoft 365-Gruppe
1 Benutzer Gruppe Gruppe
2 SourceTenantCompanyID SourceTenantCompanyID SourceTenantCompanyID
3 SourceUserUpn SourceGroupObjectID SourceGroupObjectID
4 TargetUserUpn TargetGroupObjectID TargetGroupObjectID
5 TargetUserEmail GroupName M365GroupAlias
6 UserType GroupType GroupType

Wichtig

Beim Erstellen Ihrer Identitätszuordnung für mit Gruppen verbundene Websites muss die URL der Zielwebsite mit dem Alias der neuen Gruppe übereinstimmen, die auf dem Zielmandanten erstellt wurde.

Beispiel:

  • Quellwebsite: https://contoso.sharepoint.com/teams/O365SourceGroup
  • Neuer Zielgruppenalias = O365TargetGroup

In Ihrer Identitätszuordnungsdatei muss die Zielwebsite wie folgt lauten: https://fabrikam.sharepoint.com/teams/O365TargetGroup.

Wenn der Zielalias und die Ziel-URL nicht übereinstimmen, tritt bei der Migration ein Fehler auf.

Fügen Sie keine Spaltenüberschriften in Ihre CSV-Datei ein. In den folgenden Beispielen werden sie nur zu Veranschaulichungszwecken aufgenommen.

Benutzer. Geben Sie Ihre Werte wie in diesem Beispiel für Benutzer gezeigt ein:

Zum Zuordnen von Benutzern zu verwendende Format

Beispiel für eine CSV-Datei für Benutzer

Gastbenutzer. Sie können Gastkonten im Quellmandanten Mitgliedskonten im Zielmandanten zuordnen. Sie können auch ein Gastkonto in der Quelle einem Gastkonto im Ziel zuordnen, wenn der Gast zuvor erstellt wurde. Geben Sie Ihre Werte wie in diesem Beispiel für Gäste gezeigt ein:

CSV-Beispiel beim Zuordnen eines Gasts zu einem Mitglied

CSV-Beispiel beim Zuordnen eines Gasts zu einem Gast

Gruppen. Geben Sie Ihre Werte wie in diesem Beispiel für Gruppen gezeigt ein:
Format für CSV-Datei für Gruppen

Beispiel:

Beispiel für das Hinzufügen von Gruppen zur CSV-Datei

Microsoft 365-Gruppen. Geben Sie Ihre Werte wie in diesem Beispiel für Microsoft 365-Gruppen gezeigt ein:

Format für CSV-Datei für Microsoft 365-Gruppen

Mehrere Benutzer und Gruppen in einer CSV-Datei:

Beispiel:

Beispiel für Benutzer und Gruppen in der Zuordnungsdatei

Abrufen der Unternehmens-ID des Quellmandanten

So rufen Sie die Unternehmens-ID des Quellmandanten ab:

  1. Melden Sie sich als Administrator bei Ihrem Azure-Portal an.
  2. Wählen Sie Microsoft Entra ID aus, oder suchen Sie nach Microsoft Entra ID.
  3. Scrollen Sie im linken Bereich nach unten, und wählen Sie Eigenschaften aus.
  4. Suchen Sie das Feld "Mandanten-ID". Die erforderliche Mandanten-ID befindet sich in diesem Feld.

Abrufen der Quellmandanten-ID

So rufen Sie die Objekt-ID der Quellgruppe ab:

  1. Melden Sie sich beim Quellmandanten als Administrator für Azure-Gruppen an.
  2. Suchen Sie nach Den erforderlichen Gruppen.
  3. Wählen Sie die erforderliche Gruppeninstanz und dann In Zwischenablage kopieren aus. Fügen Sie diesen Wert in die SourceGroupObjectId-Spalte Ihrer CSV-Zuordnungsdatei ein.
  4. Wenn Sie mehrere Gruppen zuordnen müssen, wiederholen Sie diese Schritte für jede Gruppe.

Abrufen der Objekt-ID der Quellgruppe

So rufen Sie die Objekt-ID der Zielgruppe ab:

  1. Melden Sie sich beim Zielmandanten als Administrator für Azure-Gruppen an.
  2. Suchen Sie nach Den erforderlichen Gruppen.
  3. Wählen Sie die erforderliche Gruppeninstanz und dann In Zwischenablage kopieren aus. Fügen Sie diesen Wert in die Spalte targetGroupObjectId ihrer CSV-Zuordnungsdatei ein.
  4. Wenn Sie mehrere Gruppen zuordnen müssen, wiederholen Sie den obigen Prozess, um diese spezifischen targetGroupObjectIds abzurufen.
  5. Verwenden Sie für GroupName die gleiche ID wie die TargetGroupObjectId , die Sie abgerufen haben.

Abrufen der Zielobjekt-ID

Hochladen der Identitätszuordnung

Nachdem die Identitätszuordnungsdatei vorbereitet wurde, lädt der SharePoint-Administrator auf dem Zielmandanten die Datei in SharePoint hoch. Dadurch kann die Identitätszuordnung automatisch im Rahmen der mandantenübergreifenden Migration erfolgen.

Wichtig

Bevor Sie den Befehl Add-SPOTenantIdentityMap -IdentityMapPath ausführen, speichern und schließen Sie die identitymap.csv Datei auf Ihrem Desktop/SharePoint/SharePoint.

Wenn die Datei geöffnet bleibt, erhalten Sie die folgende Fehlermeldung. Add-SPOTenantIdentityMap: Der Prozess kann nicht auf die Datei "C:\Users\myuser\Test-Identity-Map.csv" zugreifen, da sie von einem anderen Prozess verwendet wird.

  1. Führen Sie den folgenden Befehl aus, um die Identitätszuordnung auf den Zielmandanten hochzuladen. Geben Sie für -IdentityMapPath den vollständigen Pfad und Dateinamen der CSV-Datei für die Identitätszuordnung an.
Add-SPOTenantIdentityMap -IdentityMapPath <identitymap.csv>

Wichtig

Wenn Sie während des Lebenszyklus der Migration Änderungen an Ihrer Identitätszuordnung vornehmen oder vornehmen müssen, müssen Sie den Add-SPOTenantIdentityMap -IdentityMapPath <identitymap.csv> Befehl jedes Mal ausführen, wenn eine Änderung vorgenommen wird, um sicherzustellen, dass diese Änderungen auf die Migration angewendet werden.

Durch das Hochladen einer neuen Identitätszuordnung wird die aktuelle überschrieben. Stellen Sie sicher, dass alle Überarbeitungen oder Ergänzungen ALLE Benutzer und Gruppen für die vollständige Migration enthalten. Ihre Identitätszuordnung sollte immer alle Personen enthalten, die Sie migrieren möchten.

Um die Zuordnungseinträge in der Identitätszuordnungsdatei für einen bestimmten Benutzer anzuzeigen, verwenden Sie den Befehl Get-SPOTenantIdentityMappingUser mit Field als SourceUserKey und Value als UPN des Benutzers, den Sie verschieben.

Beispiel:

get-spoTenantIdentityMappingUser -Field SourceUserKey -Value usera@Contoso.onmicrosoft.com

Überprüfen des mandantenübergreifenden Kompatibilitätsstatus

Stellen Sie vor dem Starten mandantenübergreifender Migrationen sicher, dass beide SharePoint-Datenbankschemas auf dem neuesten Stand sind und zwischen Quelle und Ziel kompatibel sind.

Führen Sie zum Ausführen dieser Überprüfung das folgende Cmdlet auf Ihrem Quellmandanten aus.

Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostURL [Target tenant hostname]

Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostURL https://m365x12395529-my.sharepoint.com
  • Wenn der Mandantenstatus als Kompatibel oder Warnung angezeigt wird, können Sie mit dem nächsten Schritt fortfahren, um mandantenübergreifende Migrationen zu starten.
  • Wenn der Mandantenstatus als Inkompatibel angezeigt wird, müssen Ihre Mandanten gepatcht/aktualisiert werden, um die Kompatibilität sicherzustellen.
Status Kann mit der Migration fortfahren
Kompatibel Ja
Warnung Ja
Nicht kompatibel Nein

Wichtig

Es wird empfohlen, einen Zeitraum von 48 Stunden zu warten. Wenn Ihre Mandanten weiterhin als nicht kompatibel melden, wenden Sie sich an den Support.

Es wird empfohlen, die Kompatibilitätsstatusüberprüfung häufig und vor dem Starten von INSTANZEN mandantenübergreifender Migrationen durchzuführen. Wenn die Mandanten nicht kompatibel sind, kann dies zu Fehlern bei mandantenübergreifenden Migrationen führen.

Schritt 6: Starten einer mandantenübergreifenden SharePoint-Migration