CSV-Dateien für IMAP-Migrationsbatches in Exchange Online

Artikel
04/04/2023

[] Die CSV-Datei (Comma-Separated Values, durch Trennzeichen getrennte Werte), die Sie zum Migrieren der Inhalte von Benutzerpostfächern in einer IMAP-Migration verwenden, enthält eine Zeile für jeden Benutzer. Jede Zeile enthält Informationen zum Office 365-Postfach des jeweiligen Benutzers, und Office 365 verwendet diese Informationen zum Verarbeiten der Migration.

Erforderliche Attribute

Die folgenden Attribute sind für jeden Benutzer erforderlich:

" EmailAddress " gibt die Benutzer-ID für das Office 365-Postfach des Benutzers an.
" UserName " gibt den Benutzeranmeldenamen für das Postfach des Benutzers auf dem IMAP-Server an. Sie können entweder das Format benutzername oder domain\username verwenden. Zum Beispiel hollyh oder contoso\hollyh.
" Password " ist das Kennwort für das Benutzerkonto im IMAP-Messaging-System.

Die Migration schlägt fehl, wenn eines dieser Attribute nicht in die Überschriftenzeile der CSV-Datei einbezogen wird. Achten Sie auch darauf, die Attribute genauso einzugeben, wie sie angezeigt werden. Attribute dürfen keine Leerzeichen enthalten. Sie müssen ein einziges Wort sein. So ist beispielsweise " Email Address " ungültig. Sie müssen " EmailAddress " verwenden.

CSV-Dateiformat

Das folgende Beispiel zeigt das Format der CSV-Datei. In diesem Beispiel werden die Benutzeranmeldeinformationen zum Migrieren von drei Postfächern verwendet.

EmailAddress,UserName,Password
terrya@contoso.edu,contoso\terry.adams,1091990
annb@contoso.edu,contoso\ann.beebe,2111991
paulc@contoso.edu,contoso\paul.cannon,3281986

In der ersten Zeile (oder Überschriftenzeile) der CSV-Datei sind die Namen der Attribute (oder Felder) aufgelistet, die in den folgenden Zeilen angegeben sind. Die einzelnen Attributnamen werden jeweils durch ein Komma getrennt.

Die Zeilen unter der Kopfzeile stellen einen Benutzer dar und enthalten die Informationen, die zum Migrieren des Postfachs des Benutzers verwendet werden. Die Attributwerte in jeder einzelnen Zeile müssen die gleiche Reihenfolge aufweisen wie die Attributnamen in der Kopfzeile. Die einzelnen Attributwerte sind durch ein Komma getrennt.

Sie können die CSV-Datei mit einem beliebigen Texteditor oder einer Anwendung wie Microsoft Excel erstellen. Speichern Sie die Datei als CSV- oder TXT-Datei.

Tipp

Wenn die CSV-Datei ASCII-fremde Zeichen oder Sonderzeichen enthält, speichern Sie sie mit UTF-8 oder einer anderen Unicode-Codierung. Je nach Anwendung kann es möglicherweise einfacher sein, die CSV-Datei mit UTF-8 oder einer anderen Unicode-Codierung zu speichern, wenn das Systemgebietsschema des Computers mit der in der CSV-Datei verwendeten Sprache übereinstimmt.

Aufteilen einer großen Migration in mehrere Batches

Die CSV-Datei kann bis zu 50.000 Zeilen - eine Zeile für jeden Benutzer - enthalten und maximal 10 MB groß sein. Es empfiehlt sich jedoch, Benutzer in mehreren kleineren Batches zu migrieren.

Wenn Sie viele Benutzer migrieren möchten, sollten Sie sich entscheiden, welche Benutzer Sie in jeden Batch einfügen möchten. Wenn Sie beispielsweise 10.000 Konten migrieren müssen, können Sie vier Batches mit je 2.500 Benutzern ausführen. Sie können die Batches auch nach dem Alphabet, nach Benutzertyp, z. B. Dozenten, Studenten und Absolventen, nach Klasse, z. B. Erstsemester, Zweitsemester, Grundstudium, Hauptstudium, oder auf andere Weise unterteilen, je nach Anforderungen Ihres Unternehmens.

Tipp

Eine Strategie besteht darin, Office 365-Postfächer zu erstellen und E-Mails für dieselbe Benutzergruppe zu migrieren. Wenn Sie beispielsweise 100 neue Benutzer in Ihre Microsoft 365- oder Office 365-Organisation importieren, erstellen Sie einen Migrationsbatch für die gleichen 100 Benutzer. Dies ist eine effektive Möglichkeit zum Organisieren und Verwalten Ihrer Migration aus einem lokalen Messaging-System zu Office 365.

Bereitstellen von Anmeldeinformationen für Benutzer oder Administratoren

In der CSV-Datei müssen Sie den Benutzernamen und das Kennwort für das lokale Konto des Benutzers angeben. Auf diese Weise kann während des Migrationsprozesses auf das Konto zugegriffen werden. Sie können auf zwei Arten vorgehen:

Benutzeranmeldeinformationen verwenden: Dies erfordert, dass Sie die Kennwörter der Benutzer abrufen oder deren Kennwörter in einen Wert ändern, den Sie kennen, damit Sie ihn in die CSV-Datei aufnehmen können.

Tipp

Wenn Sie diese Option verwenden, müssen Sie verhindern, dass die Benutzer die Kennwörter ihrer lokalen Konten ändern. Sollten die Benutzer nämlich ihre Kennwörter nach der Erstmigration ändern, schlagen nachfolgende Synchronisierungen zwischen den Postfächern auf dem IMAP-Server und den Office 365-Postfächern fehl.
Superbenutzer- oder Administratoranmeldeinformationen verwenden: Dies erfordert, dass Sie in Ihrem IMAP-Messagingsystem ein Konto verwenden, das über die erforderlichen Rechte für den Zugriff auf alle Benutzerpostfächer verfügt. In der CSV-Datei werden die Anmeldeinformationen für dieses Konto für alle Zeilen verwendet. Informationen darüber, ob der IMAP-Server diesen Ansatz unterstützt und wie der Ansatz umgesetzt werden kann, finden Sie in der Dokumentation zum IMAP-Server.

Hinweis

Es empfiehlt sich, Administratoranmeldeinformationen zu verwenden, weil sie sich nicht auf die Benutzer auswirken oder ihnen Unannehmlichkeiten bereiten. So ist es beispielsweise unerheblich, ob Benutzer ihre Kennwörter nach der Erstmigration ändern.

Format für die Administratoranmeldeinformationen für verschiedene IMAP-Server

Sie können den Benutzernamen und das Kennwort eines Administratorkontos in den Feldern Benutzername und Kennwort für jede Zeile der CSV-Datei verwenden. Der Benutzername für Administratoranmeldeinformationen ist eine Kombination aus dem Benutzernamen für die Person, deren E-Mail migriert wird, und dem Benutzernamen für ein Administratorkonto, das über die Berechtigung für den Zugriff auf alle Benutzerpostfächer verfügt. Das unterstützte Format für Administratoranmeldeinformationen unterscheidet sich je nach dem IMAP-Server, von dem Sie E-Mails migrieren. Weitere Informationen zur Verwendung von Administratoranmeldeinformationen finden Sie in der Dokumentation zu Ihrem IMAP-Server.

Hinweis

Wenn Sie eine neue Migrationsforderung senden, wird die CSV-Datei über eine SSL-Verbindung (Secure Sockets Layer) in das Microsoft-Datencenter hochgeladen. Die Informationen aus der CSV-Datei werden verschlüsselt und auf den Microsoft Exchange-Servern im Microsoft-Datencenter gespeichert.

In den nachstehenden Abschnitten wird erläutert, wie die Administratoranmeldeinformationen in der CSV-Datei formatiert werden, die Sie zum Migrieren von E-Mails von unterschiedlichen Typen von IMAP-Servern verwenden.

Microsoft Exchange

Wenn Sie E-Mails aus der IMAP-Implementierung für Microsoft Exchange migrieren, verwenden Sie das Format Domain/Admin_UserName/User_UserName für das UserName -Attribut in der CSV-Datei. Angenommen, Sie migrieren die E-Mails für die Benutzer Terry Adams, Ann Beebe und Paul Cannon von Exchange. Sie verfügen über ein E-Mail-Administratorkonto, bei dem der Benutzername mailadmin und das Kennwort P@ssw0rd ist. Die CSV-Datei würde dann folgendermaßen aussehen:

EmailAddress,UserName,Password
terrya@contoso.edu,contoso-students/mailadmin/terry.adams,P@ssw0rd
annb@contoso.edu,contoso-students/mailadmin/ann.beebe,P@ssw0rd
paulc@contoso.edu,contoso-students/mailadmin/paul.cannon,P@ssw0rd

Dovecot

Verwenden Sie für IMAP-Server, die simple Authentication and Security Layer (SASL) unterstützen, z. B. einen Dovecot-IMAP-Server, das Format User_UserName*Admin_UserName, wobei das Sternchen ( * ) ein konfigurierbares Trennzeichen ist. Angenommen, Sie migrieren die E-Mails derselben Benutzer von einem Dovecot-IMAP-Server mithilfe der Administrator-Anmeldeinformationen mailadmin und P@ssw0rd. Die CSV-Datei würde dann folgendermaßen aussehen:

EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams*mailadmin,P@ssw0rd
annb@contoso.edu,ann.beebe*mailadmin,P@ssw0rd
paulc@contoso.edu,paul.cannon*mailadmin,P@ssw0rd

Mirapoint

Wenn Sie E-Mails von einem Mirapoint-Nachrichtenserver migrieren, verwenden Sie das Format #user@domain#Admin_UserName# für die Administratoranmeldeinformationen. Zum Migrieren von E-Mails aus Mirapoint unter Angabe der Administratoranmeldeinformationen mailadmin und des Kennworts P@ssw0rd würde Ihre CSV-Datei so aussehen:

EmailAddress,UserName,Password
terrya@contoso.edu,#terry.adams@contoso-students.edu#mailadmin#,P@ssw0rd
annb@contoso.edu,#ann.beebe@contoso-students.edu#mailadmin#,P@ssw0rd
paulc@contoso.edu,#paul.cannon@contoso-students.edu#mailadmin#,P@ssw0rd

Verwenden des optionalen UserRoot-Attributs

Einige IMAP-Server, z. B. Courier IMAP, unterstützen die Verwendung von Administratoranmeldeinformationen zum Migrieren von Postfächern zu Office 365 nicht. Um Administratoranmeldeinformationen zum Migrieren von Postfächern zu verwenden, können Sie den IMAP-Server so konfigurieren, dass virtuelle freigegebene Ordner verwendet werden. Virtuelle freigegebene Ordner ermöglichen Administratoren, mithilfe von Administratoranmeldeinformationen auf die Benutzerpostfächer auf dem IMAP-Server zuzugreifen. Weitere Informationen zum Konfigurieren von virtuellen freigegebenen Ordnern für Courier IMAP finden Sie unter Shared Folders.

Um Postfächer zu migrieren, nachdem Sie virtuelle freigegebene Ordner auf Ihrem IMAP-Server eingerichtet haben, müssen Sie das optionale Attribut " UserRoot " in die CSV-Datei einfügen. Dieses Attribut gibt für das Postfach jedes Benutzers den Speicherort an, den es in der Struktur der virtuellen freigegebenen Ordner auf dem IMAP-Server hat.

Hier ist ein Beispiel für eine CSV-Datei, die das Attribut " UserRoot " enthält:

EmailAddress,UserName,Password,UserRoot
terrya@contoso.edu,mailadmin,P@ssw0rd,/users/terry.adams
annb@contoso.edu,mailadmin,P@ssw0rd,/users/ann.beebe
paulc@contoso.edu,mailadmin,P@ssw0rd,/users/paul.cannon

Freigeben über