CSV-Dateien für Postfachmigration

Gilt für: Exchange Server 2013

Sie können eine CSV-Datei verwenden, um eine große Anzahl von Benutzerpostfächern gleichzeitig zu migrieren. Sie können eine CSV-Datei angeben, wenn Sie die Exchange-Verwaltungskonsole oder das Cmdlet New-MigrationBatch in der Exchange-Verwaltungsshell verwenden, um einen Migrationsbatch zu erstellen. Die Verwendung einer CSV-Datei, um mehrere Benutzer festzulegen, die in einem Migrationsbatch migriert werden, wird in den folgenden Migrationsszenarios unterstützt:

  • Verschiebungen in lokalen Exchange-Organisationen

    • Lokale Verschiebung: Bei einer lokalen Verschiebung werden Postfächer von einer Postfachdatenbank in eine andere verschoben. Eine lokale Verschiebung erfolgt innerhalb einer einzigen Gesamtstruktur.

    • Gesamtstrukturübergreifende Unternehmensverschiebung: Bei einer gesamtstrukturübergreifenden Unternehmensverschiebung werden Postfächer in eine andere Gesamtstruktur verschoben. Gesamtstrukturübergreifende Verschiebungen werden entweder in der Zielgesamtstruktur initiiert, bei der es sich um die Gesamtstruktur handelt, in welche die Postfächer verschoben werden sollen, oder in der Quellgesamtstruktur, bei der es sich um die Gesamtstruktur handelt, in der die Postfächer gegenwärtig gehostet werden.

    • Onboarding und Offboarding in Exchange Online

    • Onboarding-Remoteverschiebungsmigration: In einer Exchange-Hybridbereitstellung können Sie Postfächer von einer lokalen Exchange-Organisation zu Exchange Online verschieben. Dies wird auch als Onboarding einer Remoteverschiebungsmigration bezeichnet, da Sie Postfächer in Exchange Online integrieren.

    • Offboarding der Remoteverschiebungsmigration: Sie können auch eine Offboarding-Remoteverschiebungsmigration durchführen, bei der Sie Exchange Online Postfächer zu Ihrer lokalen Exchange-Organisation migrieren.

    Hinweis

    Sowohl Onboarding- als auch Offboarding-Remoteverschiebungsmigrationen werden von der Exchange Online-Organisation initiiert.

    • Mehrstufige Exchange-Migration: Sie können auch eine Teilmenge von Postfächern aus einer lokalen Exchange-Organisation zu Exchange Online migrieren. Dies ist eine andere Art der Onboardingmigration. Mit einer mehrstufigen Exchange-Migration können Sie nur Exchange 2003- und Exchange 2007-Postfächer migrieren. Bei der Migration von Exchange 2010- und Exchange 2013-Postfächern wird keine mehrstufige Migration unterstützt. Vor einer mehrstufigen Migration müssen Sie eine Verzeichnissynchronisierung durchführen oder eine andere Methode verwenden, um die E-Mail-Benutzer in Ihrer Exchange Online-Organisation bereitzustellen.

    • IMAP-Migration: Diese Art der Onboardingmigration dient dazu, Postfachdaten von einem IMAP-Server (einschließlich Exchange) zu Exchange Online zu migrieren. Bei einer IMAP-Migration müssen Sie die Postfächer in Exchange Online bereitstellen, bevor Sie Postfachdaten migrieren können.

Hinweis

Eine Exchange-Übernahmemigration unterstützt die Verwendung einer CSV-Datei nicht, da alle lokalen Benutzerpostfächer in einem einzigen Batch zu Exchange Online migriert werden.

Unterstützte Attribute für CSV-Dateien für massenweise ausgeführte Verschiebungen und Migrationen

In der ersten Zeile (auch als Kopfzeile bezeichnet) einer CSV-Datei, die zur Migration von Benutzern verwendet wird, werden die Namen der Attribute oder Felder aufgelistet, die in den folgenden Zeilen angegeben werden. Die einzelnen Attributnamen werden jeweils durch ein Komma getrennt. Jede Zeile unter der Überschriftenzeile stellt einen einzelnen Benutzer dar und liefert die für die Migration erforderlichen Informationen. Die Attribute in jeder einzelnen Benutzerzeile müssen dieselbe Reihenfolge wie die Attributnamen in der Überschriftenzeile aufweisen. Die einzelnen Attributwerte sind durch ein Komma getrennt. Wenn der Attributwert für einen bestimmten Datensatz "0" (null) lautet, geben Sie für dieses Attribut nichts ein. Stellen Sie jedoch sicher, dass das entsprechende Komma vorhanden ist, um den Nullwert vom nächsten Attribut zu trennen.

Attributwerte in der CSV-Datei überschreiben den Wert des entsprechenden Parameters, wenn der gleiche Parameter bei der Erstellung eines Migrationsbatch mit dem EAC oder der Exchange-Verwaltungsshellverwendet wird. Weitere Informationen und Beispiele finden Sie im Abschnitt Attributwerte in der CSV-Datei überschreiben die Werte für den Migrationsbatch.

Tipp

Sie können einen beliebigen Text-Editor verwenden, um die CSV-Datei zu erstellen, aber die Verwendung einer Anwendung wie Microsoft Excel erleichtert das Importieren von Daten sowie das Konfigurieren und Organisieren von CSV-Dateien. Achten Sie darauf, CSV-Dateien als .csv- oder .txt-Datei zu speichern.

In den nachstehenden Abschnitten werden die unterstützten Attribute für die Überschriftenzeile einer CSV-Datei für jeden Migrationstyp beschrieben. Jeder Abschnitt enthält eine Tabelle, in der jedes unterstützte Attribut aufgelistet wird, mit der Angabe, ob es erforderlich ist, einem Beispiel für einen Wert, der für das Attribut zu verwenden ist, und einer Beschreibung.

Hinweis

  • In den folgenden Abschnitten bezieht sich Quellumgebung auf den aktuellen Speicherort eines Benutzerpostfachs oder einer Datenbank. Zielumgebung bezieht sich auf den Speicherort, an den das Postfach migriert wird, oder auf die Datenbank, in welche das Postfach verschoben wird.
  • Alle Postfächer, die in der CSV-Datei angegeben sind, werden migriert, auch wenn sie sich außerhalb des RBAC-Bereichs befinden (z. B. eine Organisationseinheit), die dem Administrator Berechtigungen zum Migrieren von Postfächern erteilt.

Lokale Verschiebungen

Die folgende Tabelle beschreibt die unterstützten Attribute für eine CSV-Datei für lokale Verschiebungen. Weitere Informationen finden Sie unter Verwalten von lokalen Verschiebungen.

Attribut Erforderlich oder optional Akzeptierte Werte Beschreibung
EmailAddress Erforderlich SMTP-Adresse für den Benutzer Gibt den Benutzer an, der verschoben wird.
Targetdatabase Optional Datenbankname Gibt die Postfachdatenbank an, in welche das primäre Postfach des Benutzers verschoben wird. Sie können in den unterschiedlichen Zeilen der CSV-Datei unterschiedliche Datenbanken angeben, um Postfächer im gleichen Migrationsbatch in unterschiedliche Datenbanken zu verschieben.
TargetArchiveDatabase Optional Datenbank-GUID Gibt die Postfachdatenbank an, in die das Archivpostfach des Benutzers verschoben wird. Sie können in den unterschiedlichen Zeilen der CSV-Datei eine unterschiedliche Datenbank angeben, um Archivpostfächer im gleichen Migrationsbatch in unterschiedliche Datenbanken zu verschieben.

Hinweis: Wenn Sie eine bestimmte Archivdatenbank angeben, wird das Archivpostfach (sofern vorhanden) in dieselbe Datenbank wie das primäre Postfach verschoben.
BadItemLimit Optional Unlimited oder eine nicht negative ganze Zahl von 0 (Standard) bis zu einem Höchstwert von 2147483647 Gibt die Anzahl ungültiger Elemente an, die übersprungen werden, wenn der Migrationsdienst im Postfach ein beschädigtes Element vorfindet. Wenn Sie dieses Attribut in die CSV-Datei einschließen, wird der Standardwert oder ein Wert überschrieben, den Sie angeben, wenn Sie den Parameter BadItemLimit beim Erstellen des Migrationsbatches mithilfe des EAC oder der Exchange-Verwaltungsshell einschließen.

Tipp: Es wird empfohlen, den Standardwert 0 zu verwenden und den Grenzwert für ungültige Elemente für einen bestimmten Benutzer nur zu erhöhen, wenn die Verschiebung oder Migration für diesen Benutzer fehlschlägt.
MailboxType Optional Verwenden Sie einen der folgenden Werte:
  • PrimaryOnly
  • ArchiveOnly
  • PrimaryAndArchive (der Standardwert)
Gibt an, ob das primäre Postfach oder das Archivpostfach des Benutzers oder beides verschoben werden sollen.

Onboarding-Remoteverschiebungsmigration in einer Hybridbereitstellung

Sie können Postfächer in einer Hybridbereitstellung von einer lokalen Exchange-Organisation zu Exchange Online verschieben. Beim Hinzufügen von Postfächern wird der Migrationsbatch in der Exchange Online-Organisation erstellt und durch einen Exchange Online-Administrator initiiert. Weitere Informationen finden Sie unter Verschieben von Postfächern zwischen lokalen und Exchange Online Organisationen in Hybridbereitstellungen.

Die folgende Tabelle beschreibt die unterstützten Attribute für eine CSV-Datei für Onboarding-Remoteverschiebungsmigrationen.

Attribut Erforderlich oder optional Akzeptierte Werte Beschreibung
EmailAddress Erforderlich SMTP-Adresse für den Benutzer Gibt die E-Mail-Adresse für den E-Mail-aktivierten Benutzer in der Exchange Online-Organisation an, der dem lokalen Benutzerpostfach entspricht, das migriert wird.
BadItemLimit Optional Unlimited oder eine nicht negative ganze Zahl von 0 (Standard) bis zu einem Höchstwert von 2147483647 Gibt die Anzahl ungültiger Elemente an, die übersprungen werden, wenn der Migrationsdienst im Postfach ein beschädigtes Element vorfindet. Wenn Sie dieses Attribut in die CSV-Datei einschließen, überschreibt es den Standardwert oder den Wert, den Sie angeben, wenn Sie den Parameter BadItemLimit beim Erstellen des Migrationsbatches mithilfe des EAC oder der Exchange-Verwaltungsshell einschließen.

Tipp: Es wird empfohlen, den Standardwert 0 zu verwenden und den Grenzwert für ungültige Elemente für einen bestimmten Benutzer nur zu erhöhen, wenn die Verschiebung oder Migration für diesen Benutzer fehlschlägt.
LargeItemLimit Optional Unlimited oder eine nicht negative ganze Zahl von 0 (Standard) bis zu einem Höchstwert. Gibt die Anzahl großer Elemente in dem Postfach des Benutzers an, die übersprungen werden. Wenn die Anzahl großer Elemente diesen Wert übersteigt, tritt bei der Migration des Postfachs ein Fehler auf.

Der Standardwert lautet 0. In diesem Fall wird bei der Migration ein Fehler gemeldet, wenn das Postfach auch nur ein großes Element enthält.

Beim Onboarding von Postfächern in Exchange Online werden Elemente bis zu 35 MB migriert.
MailboxType Optional Verwenden Sie einen der folgenden Werte:
  • PrimaryOnly
  • ArchiveOnly
  • PrimaryAndArchive (der Standardwert)
Gibt an, ob das primäre Postfach oder das Archivpostfach des Benutzers oder beides verschoben werden sollen.

Gesamtstrukturübergreifende Unternehmensverschiebungen und Offboarding-Remoteverschiebungsmigrationen in einer Hybridbereitstellung

Wie bereits erwähnt, werden gesamtstrukturübergreifende Verschiebungen entweder von der Zielgesamtstruktur oder der Quellgesamtstruktur initiiert. Offboarding-Remoteverschiebungsmigrationen werden von der Exchange Online-Organisation initiiert. Weitere Informationen finden Sie unter:

Die folgende Tabelle beschreibt die unterstützten Attribute für eine CSV-Datei für gesamtstrukturübergreifende Unternehmensverschiebungen und Offboarding-Remoteverschiebungsmigrationen in einer Exchange-Hybridbereitstellung.

Attribut Erforderlich oder optional Akzeptierte Werte Beschreibung
EmailAddress Erforderlich SMTP-Adresse für den Benutzer Bei gesamtstrukturübergreifenden Unternehmensverschiebungen gibt dieser Wert das Postfach oder den E-Mail-aktivierten Benutzer in der Quellgesamtstruktur an.

Für das Offboarding von Remoteverschiebungsmigrationen wird die Exchange Online Postfach angegeben.
Targetdatabase Erforderlich bei Offboarding-Remoteverschiebungsmigrationen und gesamtstrukturübergreifenden Unternehmensverschiebungen, die von der Quellgesamtstruktur initiiert werden. Alternativ kann dieses Attribut beim Erstellen des Migrationsbatches im EAC oder mithilfe der Exchange-Verwaltungsshell angegeben werden.

Dieses Attribut ist bei gesamtstrukturübergreifenden Unternehmensverschiebungen, die von der Zielgesamtstruktur initiiert werden, optional.
Datenbankname Gibt die Postfachdatenbank in der Zielgesamtstruktur an, in welche das primäre Postfach des Benutzers verschoben wird. Sie können in den unterschiedlichen Zeilen der CSV-Datei eine unterschiedliche Datenbank angeben, um Postfächer im gleichen Migrationsbatch in unterschiedliche Datenbanken zu verschieben.
TargetArchiveDatabase Optional Datenbankname Gibt die Postfachdatenbank in der Zielgesamtstruktur an, in welche das Archivpostfach des Benutzers verschoben wird. Sie können in den unterschiedlichen Zeilen der CSV-Datei eine unterschiedliche Datenbank angeben, um Archivpostfächer im gleichen Migrationsbatch in unterschiedliche Datenbanken zu verschieben.
BadItemLimit Optional Unlimited oder eine nicht negative ganze Zahl von 0 (Standard) bis zu einem Höchstwert von 2147483647 Gibt die Anzahl ungültiger Elemente an, die übersprungen werden, wenn der Migrationsdienst im Postfach ein beschädigtes Element vorfindet. Wenn Sie dieses Attribut in die CSV-Datei einschließen, überschreibt es den Standardwert oder den Wert, den Sie angeben, wenn Sie den Parameter BadItemLimit beim Erstellen des Migrationsbatches mithilfe des EAC oder der Exchange-Verwaltungsshell einschließen.

Tipp: Es wird empfohlen, den Standardwert 0 zu verwenden und den Grenzwert für ungültige Elemente für einen bestimmten Benutzer nur zu erhöhen, wenn die Verschiebung oder Migration für diesen Benutzer fehlschlägt.
LargeItemLimit Optional Unlimited oder eine nicht negative ganze Zahl von 0 (Standard) bis zu einem Höchstwert. Gibt die Anzahl großer Elemente in dem Postfach des Benutzers an, die übersprungen werden. Wenn die Anzahl großer Elemente diesen Wert übersteigt, tritt bei der Migration des Postfachs ein Fehler auf.

Der Standardwert lautet 0. In diesem Fall wird bei der Migration ein Fehler gemeldet, wenn das Postfach auch nur ein großes Element enthält.

Beim Onboarding von Postfächern in Exchange Online werden Elemente bis zu 35 MB migriert.
MailboxType Optional Verwenden Sie einen der folgenden Werte:
  • PrimaryOnly
  • ArchiveOnly
  • PrimaryAndArchive (der Standardwert)
Gibt an, ob das primäre Postfach oder das Archivpostfach des Benutzers oder beides verschoben werden sollen.

Mehrstufige Exchange-Migrationen

Sie müssen eine CSV-Datei verwenden, um die Gruppe von Benutzern für einen Migrationsbatch anzugeben, wenn Sie lokale Exchange 2003- und Exchange 2007-Postfächer mithilfe einer phasenweisen Exchange-Migration zu Exchange Online migrieren möchten. Es gibt keine Beschränkung der Anzahl von Postfächern, die Sie mit einer mehrstufigen Exchange-Migration zur Cloud migrieren können. Die CSV-Datei für einen Migrationsbatch kann jedoch maximal 1.000 Zeilen enthalten. Zum Migrieren von mehr als 1.0000 Postfächern müssen Sie zusätzliche CSV-Dateien erstellen und dann mit jeder dieser Dateien einen neuen Migrationsbatch erstellen. Weitere Informationen zu phasenweisen Exchange-Migrationen finden Sie unter Migrieren von Postfächern zu Exchange Online mit einer mehrstufigen Migration.

Die folgende Tabelle beschreibt die unterstützten Attribute für eine CSV-Datei für eine phasenweise Exchange-Migration.

Attribut Erforderlich oder optional Akzeptierte Werte Beschreibung
EmailAddress Erforderlich SMTP-Adresse für den Benutzer Gibt die E-Mail-Adresse für den E-Mail-aktivierten Benutzer (oder ein Postfach, wenn Sie die Migration wiederholen) in Exchange Online an, die dem lokalen Benutzerpostfach entspricht, das migriert wird. E-Mail-aktivierte Benutzer werden als Ergebnis der Verzeichnissynchronisierung oder eines anderen Bereitstellungsprozesses in Exchange Online erstellt. Die E-Mail-Adresse des E-Mail-aktivierten Benutzers muss mit der WindowsEmailAddress-Eigenschaft für das entsprechende lokale Postfach übereinstimmen.
Kennwort Optional Ein Kennwort muss mindestens acht Zeichen lang sein und alle Kennworteinschränkungen erfüllen, die für Ihre Microsoft 365- oder Office 365 Organisation gelten. Dieses Kennwort wird für das Benutzerkonto festgelegt, wenn der entsprechende E-Mail-aktivierte Benutzer in Exchange Online während der Migration in ein Postfach umgewandelt wird.
ForceChangePassword Optional True oder False Gibt an, ob ein Benutzer das Kennwort ändern muss, wenn er sich das erste Mal am neuen Exchange Online-Postfach anmeldet.

Hinweis: Wenn Sie eine Lösung für einmaliges Anmelden implementiert haben, indem Sie Active Directory-Verbunddienste (AD FS) 2.0 (AD FS 2.0) in Ihrer lokalen Organisation bereitstellen, müssen Sie für den Wert dieses Attributs verwendenFalse.

IMAP-Migrationen

Eine CSV-Datei für einen IMAP-Migrationsbatch kann maximal 50.000 Zeilen enthalten. Es empfiehlt sich jedoch, Benutzer in mehreren kleineren Batches zu migrieren. Weitere Informationen zu IMAP-Migrationen finden Sie unter den folgenden Themen:

Die folgende Tabelle beschreibt die unterstützten Attribute für eine CSV-Datei für eine IMAP-Migration.

Attribut Erforderlich oder optional Akzeptierte Werte Beschreibung
EmailAddress Erforderlich SMTP-Adresse für den Benutzer. Gibt die Benutzer-ID für das Exchange Online-Postfach des Benutzers an
UserName Erforderlich Zeichenfolge zur Identifizierung des Benutzers im IMAP-Messaging-System in einem vom IMAP-Server unterstützten Format Gibt den Anmeldenamen für das Konto des Benutzers im IMAP-Messaging-System (der Quellumgebung) an. Zusätzlich zum Benutzernamen können Sie die Anmeldeinformationen eines Kontos verwenden, das den erforderlichen Berechtigungen zum Zugreifen auf die Postfächer auf dem IMAP-Server zugewiesen wurde. Weitere Informationen finden Sie unter CSV-Dateien für IMAP-Migrationsbatches.
Password Erforderlich Kennwortzeichenfolge Gibt das Kennwort für das vom Attribut "UserName" angegebene Benutzerkonto an.

Attributwerte in der CSV-Datei überschreiben die Werte für den Migrationsbatch

Attributwerte in der CSV-Datei überschreiben den Wert des entsprechenden Parameters, wenn der gleiche Parameter bei der Erstellung eines Migrationsbatch mit der Exchange-Verwaltungskonsole oder der Exchange-Verwaltungsshell verwendet wird. Wenn der Migrationsbatchwert auf einen Benutzer angewendet werden soll, muss die Zelle in der CSV-Datei leer bleiben. So können Sie bestimmte Attributwerte für ausgewählte Benutzer in einem Migrationsbatch beliebig kombinieren.

Beispiel: Angenommen, Sie erstellen in der Exchange-Verwaltungsshell mit dem folgenden Exchange-Verwaltungsshell-Befehl einen Batch für eine gesamtstrukturübergreifende Unternehmensverschiebung, um das primäre und Archivpostfach der Benutzer in die Zielgesamtstruktur zu verschieben.

New-MigrationBatch -Name CrossForestBatch1 -SourceEndpoint ForestEndpoint1 -TargetDeliveryDomain forest2.contoso.com -TargetDatabases @(EXCH-MBX-02,EXCH-MBX-03) -TargetArchiveDatabases @(EXCH-MBX-A02,EXCH-MBX-A03) -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\CrossForestBatch1.csv")) -AutoStart

Hinweis

Da primäre und Archivpostfächer standardmäßig verschoben werden, müssen Sie dies im Exchange-Verwaltungsshell-Befehl nicht explizit angeben.

Ein Teil der Datei "CrossForestBatch1.csv" für diesen Migrationsbatch sieht folgendermaßen aus:

EmailAddress,TargetDatabase,TargetArchiveDatabase
user1@contoso.com,EXCH-MBX-01,EXCH-MBX-A01
user2@contoso.com,,
user3@contoso.com,EXCH-MBX-01,
...

Da die Werte in der CSV-Datei die Werte für den Migrationsbatch überschreiben, werden die primären Postfächer und Archivpostfächer für user1 in exch-MBX-01 bzw. EXCH-MBX-A01 in der Zielgesamtstruktur verschoben. Die primären und Archivpostfächer für user2 werden entweder nach EXCH-MBX-02 oder EXCH-MBX-03 verschoben. Das primäre Postfach für user3 wird nach EXCH-MBX-01 verschoben, und das Archivpostfach wird nach EXCH-MBX-A02 oder EXCH-MBX-A03 verschoben.

Ein weiteres Beispiel: Angenommen, Sie erstellen mit dem folgenden Befehl einen Batch für eine Onboarding-Remoteverschiebungsmigration in einer Hybridbereitstellung, um Archivpostfächer zu Exchange Online zu verschieben.

New-MigrationBatch -Name OnBoarding1 -SourceEndpoint RemoteEndpoint1 -TargetDeliveryDomain cloud.contoso.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\OnBoarding1.csv")) -MailboxType ArchiveOnly -AutoStart

Sie möchte allerdings für ausgewählte Benutzer auch die primären Postfächer verschieben. Somit würde ein Teil der Datei "OnBoarding1.csv" für diesen Migrationsbatch wie folgt aussehen:

EmailAddress,MailboxType
user1@contoso.com,
user2@contoso.com,
user3@cloud.contoso.com,PrimaryAndArchive
user4@cloud.contoso.com,PrimaryAndArchive
...

Da der Wert für den Postfachtyp in der CSV-Datei die Werte für den Parameter MailboxType im Befehl zum Erstellen des Batches überschreibt, wird nur das Archivpostfach für user1 und user2 zu Exchange Online migriert. Bei Benutzer3 und Benutzer4 werden hingegen das primäre und das Archivpostfach zu Exchange Online verschoben.