Verwenden von PowerShell zum Ausführen einer IMAP-Migration zu Microsoft 365
Dieser Artikel gilt sowohl für Microsoft 365 Enterprise als auch für Office 365 Enterprise.
Im Rahmen der Bereitstellung von Microsoft 365 können Sie den Inhalt von Benutzerpostfächern von einem IMAP-E-Mail-Dienst (Internet Mail Access Protocol) zu Microsoft 365 migrieren. Dieser Artikel führt Sie durch die Aufgaben für eine IMAP-Migration mithilfe von Exchange Online PowerShell.
Hinweis
Sie können auch das Exchange Admin Center verwenden, um eine IMAP-Migration durchzuführen. Weitere Informationen finden Sie unter Migrieren Ihrer IMAP-Postfächer.
Was sollten Sie wissen, bevor Sie beginnen?
Geschätzte Zeit bis zum Abschließen dieser Aufgabe: 2 bis 5 Minuten, um einen Migrationsbatch zu erstellen. Nach dem Start der Migration variiert die Dauer der Migration abhängig von der Anzahl von Postfächern in dem Batch, der Größe der einzelnen Postfächer und Ihrer verfügbaren Netzkapazität. Informationen zu anderen Faktoren, die sich darauf auswirken, wie lange die Migration von Postfächern zu Microsoft 365 dauert, finden Sie unter Migrationsleistung.
Bevor Sie dieses Verfahren bzw. diese Verfahren ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Um zu sehen, welche Berechtigungen Sie benötigen, lesen Sie den Eintrag "Migration" in einer Tabelle im Artikel Empfängerberechtigungen .
Um die Exchange Online-PowerShell-Cmdlets zu verwenden, müssen Sie angemeldet sein und die Cmdlets in Ihre lokale Windows PowerShell Sitzung importieren. Anweisungen finden Sie unter Herstellen einer Verbindung mit Exchange Online PowerShell.
Eine vollständige Liste der Migrationsbefehle finden Sie unter Verschiebungs- und Migrations-Cmdlets.
Folgende Einschränkungen gelten für IMAP-Migrationen:
Nur Elemente aus dem Posteingang oder anderen E-Mail-Ordnern eines Benutzers können migriert werden. Sie können keine Kontakte, Kalenderelemente oder Aufgaben migrieren.
Maximal 500.000 Elemente können aus dem Postfach eines Benutzers migriert werden.
Die maximale Nachrichtengröße, die migriert werden kann, beträgt 35 MB.
Migrationsschritte
Schritt 1: IMAP-Migration vorbereiten
Wenn Sie über eine Domäne für Ihre IMAP-organization verfügen, fügen Sie sie als akzeptierte Domäne Ihres Microsoft 365-organization hinzu. Wenn Sie dieselbe Domäne verwenden möchten, die Sie bereits für Ihre Microsoft 365-Postfächer besitzen, müssen Sie sie zuerst als akzeptierte Domäne zu Microsoft 365 hinzufügen. Nachdem Sie es hinzugefügt haben, können Sie Ihre Benutzer in Microsoft 365 erstellen. Weitere Informationen finden Sie unterÜberprüfen Ihrer Domäne.
Fügen Sie jeden Benutzer zu Microsoft 365 hinzu, damit sie über ein Postfach verfügen. Anweisungen finden Sie unterHinzufügen von Benutzern zu Microsoft 365 Business.
Abrufen des FQDN des IMAP-Servers. Sie müssen den vollqualifizierten Domänennamen (FQDN) (auch als vollständiger Computername bezeichnet) des IMAP-Servers angeben, von dem Sie Postfachdaten migrieren, wenn Sie einen IMAP-Migrationsendpunkt erstellen. Verwenden Sie einen IMAP-Client oder den Ping-Befehl, um sicherzustellen, dass Sie mit dem FQDN über das Internet mit dem IMAP-Server kommunizieren können.
Konfigurieren der Firewall zum Zulassen von IMAP-Verbindungen. Sie müssen unter Umständen Ports in der Firewall der Organisation öffnen, in der sich der IMAP-Server befindet, damit Netzwerkdatenverkehr, der während der Migration aus dem Microsoft-Datencenter stammt, in die Organisation gelangen darf, in der sich der IMAP-Server befindet. Eine Liste der IP-Adressen, die von Microsoft-Datencentern verwendet werden, finden Sie unter Ausgehende IP-Adressen.
Zuweisen der Administratorkontoberechtigungen für den Zugriff auf Postfächer in der IMAP-Organisation. Wenn Sie Administratoranmeldeinformationen in der CSV-Datei verwenden, muss das verwendete Konto die erforderlichen Berechtigungen für den Zugriff auf die lokalen Postfächer besitzen. Die für den Zugriff auf Benutzerpostfächer erforderlichen Berechtigungen werden durch den jeweiligen IMAP-Server bestimmt.
Um die Exchange Online-PowerShell-Cmdlets zu verwenden, müssen Sie angemeldet sein und die Cmdlets in Ihre lokale Windows PowerShell-Sitzung importieren. Anweisungen finden Sie unter Herstellen einer Verbindung mit Exchange Online PowerShell.
Eine vollständige Liste der Migrationsbefehle finden Sie unter Verschiebungs- und Migrations-Cmdlets.
Überprüfen, ob Sie mit Ihrem IMAP-Server eine Verbindung herstellen können. Führen Sie in Exchange Online PowerShell den folgenden Befehl aus, um die Einstellungen für die Verbindung mit Ihrem IMAP-Server zu testen.
Test-MigrationServerAvailability -IMAP -RemoteServer <FQDN of IMAP server> -Port <143 or 993> -Security <None, Ssl, or Tls>Normalerweise wird für den Port -Parameter der Wert 143 für unverschlüsselte oder TLS-Verbindungen (Transport Layer Security) verwendet und der Wert 993 für SSL-Verbindungen.
Schritt 2: CSV-Datei für einen IMAP-Migrationsbatch erstellen
Identifizieren Sie die Gruppe der Benutzer, deren Postfächer Sie in einem IMAP-Migrationsbatch migrieren möchten. Jede Zeile in der CSV-Datei enthält Informationen, die zum Herstellen einer Verbindung mit einem Postfach im IMAP-Messaging-System erforderlich sind.
Die folgenden Attribute sind für jeden Benutzer erforderlich:
EmailAddress gibt die Benutzer-ID für das Microsoft 365-Postfach des Benutzers an.
UserName gibt den Anmeldenamen für das Konto an, das für den Zugriff auf das Postfach auf dem IMAP-Server verwendet werden soll.
Password gibt das Kennwort für das Konto in der Spalte UserName UserName an.
Das folgende Beispiel zeigt das Format der CSV-Datei. In diesem Beispiel werden drei Postfächer migriert:
EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams,1091990
annb@contoso.edu,ann.beebe,2111991
paulc@contoso.edu,paul.cannon,3281986
Für das Attribut UserName können Sie zusätzlich zum Benutzernamen die Anmeldeinformationen eines Kontos verwenden, dem die erforderlichen Berechtigungen für den Zugriff auf Postfächer auf dem IMAP-Server zugewiesen wurden. Es folgen einige spezielle Formate, die für einige IMAP-Server verwendet werden:
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 haben ein Administrator-E-Mail-Konto, dessen Benutzername mailadmin mailadmin und dessen Kennwort P@ssw0rd P@ssw0rd lautet. 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 wie Dovecot-IMAP-Server, die Simple Authentication and Security Layer (SASL) unterstützen, 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 von Mirapoint mithilfe der Administratoranmeldeinformationen mailadmin mailadmin und P@ssw0rd P@ssw0rd würde die CSV-Datei folgendermaßen 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
Courier IMAP:
Einige Quell-E-Mail-Systeme, z. B. Courier IMAP, unterstützen die Verwendung von Postfachadministratoranmeldeinformationen zum Migrieren von Postfächern zu Microsoft 365 nicht. Stattdessen können Sie Ihr E-Mail-Quellsystem für die Verwendung virtueller freigegebener Ordner einrichten. Mithilfe der virtuellen freigegebenen Ordner können Sie die Postfach-Administratoranmeldeinformationen verwenden, um auf Benutzerpostfächer im E-Mail-Quellsystem 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 auf dem E-Mail-Quellsystem virtuelle freigegebene Ordner eingerichtet haben, müssen Sie das optionale Attribut UserRoot in die Migrationsdatei einfügen. Dieses Attribut gibt das Verzeichnis an, in dem die einzelnen Benutzerpostfächer in der Struktur der virtuellen freigegebenen Ordner im E-Mail-Quellsystem gespeichert sind. Der Pfad zu Terrys Postfach lautet beispielsweise „/users/terry.adams".
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
Schritt 3: IMAP-Migrationsendpunkt erstellen
Um E-Mails erfolgreich zu migrieren, muss Microsoft 365 eine Verbindung mit dem Quell-E-Mail-System herstellen und mit diesem kommunizieren. Dazu verwendet Microsoft 365 einen Migrationsendpunkt. Der Migrationsendpunkt definiert außerdem die Anzahl der Postfächer, die gleichzeitig migriert werden, sowie die Anzahl der Postfächer, die gleichzeitig während einer inkrementellen Synchronisierung synchronisiert werden, die alle 24 Stunden auftritt. Um einen Migrationsendpunkt für die IMAP-Migration zu erstellen, stellen Sie zunächst eine Verbindung mit Exchange Online her.
Eine vollständige Liste der Migrationsbefehle finden Sie unter Verschiebungs- und Migrations-Cmdlets.
Zum Erstellen eines IMAP-Migrationsendpunkts namens „IMAPEndpoint“ in Exchange Online PowerShell, führen Sie den folgenden Befehl aus:
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 993 -Security Ssl
Sie können auch Parameter zum Angeben gleichzeitiger Migrationen, gleichzeitiger inkrementeller Migrationen und des zu verwendenden Ports hinzufügen. Der folgende Exchange Online PowerShell-Befehl erstellt einen IMAP-Migrationsendpunkt namens „IMAPEndpoint", der 50 gleichzeitige Migrationen und bis zu 25 gleichzeitige inkrementelle Synchronisierungen unterstützt. Darüber hinaus wird der Endpunkt für die Verwendung von Port 143 für die TLS-Verschlüsselung konfiguriert.
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations
50 -MaxConcurrentIncrementalSyncs 25
Weitere Informationen zu den New-MigrationEndpoint -Cmdlets finden Sie unterNew-MigrationEndpoint.
Stellen Sie die Funktion sicher
Führen Sie den folgenden Befehl in Exchange Online PowerShell aus, um Informationen über den „IMAPEndpoint“ anzuzeigen:
Get-MigrationEndpoint IMAPEndpoint | Format-List EndpointType,RemoteServer,Port,Security,Max*
Schritt 4: Erstellen und Starten eines IMAP-Migrationsbatches
Sie können das New-MigrationBatch-Cmdlet verwenden, um einen Migrationsbatch für eine IMAP-Migration zu erstellen. Sie können einen Migrationsbatch erstellen und automatisch durch Einschließen des AutoStart-Parameters starten. Alternativ können Sie den Migrationsbatch erstellen und danach mithilfe des Start-MigrationBatch-Cmdlets starten.
Der folgende Exchange Online PowerShell-Befehl startet automatisch den Migrationsbatch namens „IMAPBatch1“ mit den IMAP-Endpunkt namens „IMAPEndpoint“:
New-MigrationBatch -Name IMAPBatch1 -SourceEndpoint IMAPEndpoint -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -AutoStart
Stellen Sie die Funktion sicher
Führen Sie das Get-MigrationBatch-Cmdlet aus, um Informationen zu „IMAPBatch1" anzuzeigen:
Get-MigrationBatch -Identity IMAPBatch1 | Format-List
Sie können auch überprüfen, ob der Batch gestartet wurde, indem Sie den folgenden Befehl ausführen:
Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status
Schritt 5: Weiterleiten Ihrer E-Mail an Microsoft 365
E-Mail-Systeme verwenden einen als MX-Eintrag bezeichneten DNS-Eintrag, um zu ermitteln, wohin E-Mails gesendet werden sollen. Während der E-Mail-Migration hat Ihr MX-Eintrag auf Ihr Quell-E-Mail-System verwiesen. Nachdem die E-Mail-Migration zu Microsoft 365 abgeschlossen ist, ist es an der Zeit, Ihren MX-Eintrag auf Microsoft 365 zu verweisen. Dadurch wird sichergestellt, dass E-Mails an Ihre Microsoft 365-Postfächer übermittelt werden. Durch Verschieben des MX-Eintrags können Sie auch Ihr altes E-Mail-System deaktivieren, wenn Sie bereit sind.
Für viele DNS-Anbieter gibt es bestimmte Anweisungen zum Ändern des MX-Eintrags. Für den Fall, dass Ihr DNS-Anbieter nicht aufgeführt ist oder Sie eine Vorstellung von den allgemeinen Anweisungen erhalten möchten, werden auch allgemeine Anweisungen für MX-Einträge bereitgestellt.
Es kann bis zu 72 Stunden dauern, bis die E-Mail-Systeme der Kunden und Partnern den geänderten MX-Eintrag erkennen. Warten Sie mindestens 72 Stunden, bevor Sie mit dem nächsten Schritt fortfahren: Schritt 6: IMAP-Migrationsbatch löschen.
Schritt 6: IMAP-Migrationsbatch löschen
Nachdem Sie den MX-Eintrag geändert und überprüft haben, dass alle E-Mails an Microsoft 365-Postfächer weitergeleitet werden, benachrichtigen Sie die Benutzer, dass ihre E-Mails an Microsoft 365 gehen. Danach können Sie den IMAP-Migrationsbatch löschen. Überprüfen Sie Folgendes, bevor Sie den Migrationsbatch löschen.
Alle Benutzer verwenden Microsoft 365-Postfächer. Nachdem der Batch gelöscht wurde, werden E-Mails, die an Postfächer im lokalen Exchange Server gesendet werden, nicht in die entsprechenden Microsoft 365-Postfächer kopiert.
Microsoft 365-Postfächer wurden mindestens einmal synchronisiert, nachdem E-Mails direkt an sie gesendet wurden. Stellen Sie dazu sicher, dass der Wert im Feld Letzte Synchronisierungszeit für den Migrationsbatch aktueller ist als der Zeitpunkt, zu dem E-Mails direkt an Microsoft 365-Postfächer weitergeleitet wurden.
Führen Sie den folgenden Befehl aus, um den Migrationsbatch „IMAPBatch1“ in Exchange Online PowerShell zu löschen:
Remove-MigrationBatch -Identity IMAPBatch1
Weitere Informationen zu dem Remove-MigrationBatch -Cmdlet finden Sie unterRemove-MigrationBatch.
Stellen Sie die Funktion sicher
Führen Sie den folgenden Befehl in Exchange Online PowerShell aus, um Informationen über den "IMAPBatch1" anzuzeigen:
Get-MigrationBatch IMAPBatch1"
Der Befehl gibt entweder den Migrationsbatch mit dem Status Removing zurück oder einen Fehler, der besagt, dass der Migrationsbatch nicht gefunden werden konnte, was bestätigt, dass er gelöscht wurde.
Weitere Informationen zu den Get-MigrationBatch -Cmdlets finden Sie unterGet-MigrationBatch.