PowerShell gebruiken om een IMAP-migratie naar Microsoft 365 uit te voeren
Dit artikel is van toepassing op Microsoft 365 Enterprise en Office 365 Enterprise.
Als onderdeel van het implementatieproces van Microsoft 365 kunt u ervoor kiezen om de inhoud van postvakken van gebruikers te migreren van een IMAP-e-mailservice (Internet Mail Access Protocol) naar Microsoft 365. In dit artikel wordt u begeleid bij de taken voor een e-mail-IMAP-migratie met behulp van Exchange Online PowerShell.
Opmerking
U kunt ook het Exchange-beheercentrum gebruiken om een IMAP-migratie uit te voeren. Zie Uw IMAP-postvakken migreren.
Wat moet u weten voordat u begint?
Geschatte tijd voor het voltooien van deze taak: 2-5 minuten om een migratiebatch te maken. Nadat de migratiebatch is gestart, varieert de duur van de migratie op basis van het aantal postvakken in de batch, de grootte van elk postvak en uw beschikbare netwerkcapaciteit. Zie Migratieprestaties voor informatie over andere factoren die van invloed zijn op hoe lang het duurt om postvakken te migreren naar Microsoft 365.
U moet beschikken over bepaalde machtigingen om deze procedure of procedures te kunnen uitvoeren. Zie de vermelding Migratie in een tabel in het artikel Machtigingen voor ontvangers om te zien welke machtigingen u nodig hebt.
Als u de Exchange Online PowerShell-cmdlets wilt gebruiken, moet u zich aanmelden en de cmdlets importeren in uw lokale Windows PowerShell sessie. Zie Verbinding maken met Exchange Online PowerShell voor instructies.
Zie Cmdlets verplaatsen en migreren voor een volledige lijst met migratieopdrachten.
De volgende beperkingen zijn van toepassing op IMAP-migraties:
Alleen items in het Postvak IN van een gebruiker of andere e-mailmappen kunnen worden gemigreerd. U kunt geen contactpersonen, agenda-items of taken migreren.
Er kunnen maximaal 500.000 items worden gemigreerd vanuit het postvak van een gebruiker.
De maximale berichtgrootte die kan worden gemigreerd, is 35 MB.
Migratiestappen
Stap 1: voorbereiden op een IMAP-migratie
Als u een domein voor uw IMAP-organisatie hebt, voegt u dit toe als een geaccepteerd domein van uw Microsoft 365-organisatie. Als u hetzelfde domein wilt gebruiken dat u al hebt voor uw Microsoft 365-postvakken, moet u dit eerst toevoegen als een geaccepteerd domein aan Microsoft 365. Nadat u deze hebt toegevoegd, kunt u uw gebruikers maken in Microsoft 365. ZieUw domein verifiëren voor meer informatie.
Voeg elke gebruiker toe aan Microsoft 365 zodat deze een postvak heeft. ZieGebruikers toevoegen aan Microsoft 365 voor Bedrijven voor instructies.
Haal de FQDN van de IMAP-server op. U moet de FQDN (Fully Qualified Domain Name) (ook wel de volledige computernaam genoemd) van de IMAP-server opgeven van waaruit u postvakgegevens migreert wanneer u een IMAP-migratie-eindpunt maakt. Gebruik een IMAP-client of de opdracht PING om te controleren of u de FQDN kunt gebruiken om met de IMAP-server op internet te communiceren.
Configureer de firewall om IMAP-verbindingen toe te staan. Mogelijk moet u poorten openen in de firewall van de organisatie die als host fungeert voor de IMAP-server, zodat netwerkverkeer dat afkomstig is van het Microsoft-datacenter tijdens de migratie toegang heeft tot de organisatie die als host fungeert voor de IMAP-server. Zie EXCHANGE ONLINE URL's en IP-adresbereiken voor een lijst met IP-adressen die worden gebruikt door Microsoft-datacenters.
Wijs de beheerdersaccountmachtigingen toe voor toegang tot postvakken in uw IMAP-organisatie. Als u beheerdersreferenties in het CSV-bestand gebruikt, moet de account die u gebruikt beschikken over de vereiste machtigingen om toegang te kunnen krijgen tot de lokale postvakken. De machtigingen die vereist zijn voor toegang tot postvakken van gebruikers, worden bepaald door de specifieke IMAP-server.
Als u de Exchange Online PowerShell-cmdlets wilt gebruiken, moet u zich aanmelden en de cmdlets importeren in uw lokale Windows PowerShell sessie. Zie Verbinding maken met Exchange Online PowerShell voor instructies.
Zie Cmdlets verplaatsen en migreren voor een volledige lijst met migratieopdrachten.
Controleer of u verbinding kunt maken met uw IMAP-server. Voer de volgende opdracht uit in Exchange Online PowerShell om de verbindingsinstellingen met uw IMAP-server te testen.
Test-MigrationServerAvailability -IMAP -RemoteServer <FQDN of IMAP server> -Port <143 or 993> -Security <None, Ssl, or Tls>Voor de waarde van de poortparameter is het gebruikelijk om 143 te gebruiken voor niet-versleutelde of TLS-verbindingen (Transport Layer Security) en om 993 te gebruiken voor SSL-verbindingen.
Stap 2: een CSV-bestand maken voor een IMAP-migratiebatch
Identificeer de groep gebruikers van wie u de postvakken wilt migreren in een IMAP-migratiebatch. Elke rij in het CSV-bestand bevat informatie die nodig is om verbinding te maken met een postvak in het IMAP-berichtensysteem.
Hier volgen de vereiste kenmerken voor elke gebruiker:
EmailAddress geeft de gebruikers-id op voor het Microsoft 365-postvak van de gebruiker.
UserName geeft de aanmeldingsnaam op voor het account dat moet worden gebruikt voor toegang tot het postvak op de IMAP-server.
Wachtwoord geeft het wachtwoord voor het account op in de kolom Gebruikersnaam .
Hier volgt een voorbeeld van de indeling van het CSV-bestand. In dit voorbeeld worden drie postvakken gemigreerd:
EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams,1091990
annb@contoso.edu,ann.beebe,2111991
paulc@contoso.edu,paul.cannon,3281986
Voor het kenmerk UserName kunt u, naast de gebruikersnaam, de referenties gebruiken van een account waaraan de benodigde machtigingen zijn toegewezen voor toegang tot postvakken op de IMAP-server. Hier volgen enkele van de specifieke indelingen die voor sommige IMAP-servers worden gebruikt:
Microsoft Exchange:
Als u e-mail vanaf de IMAP-implementatie voor Microsoft Exchange migreert, gebruikt u de notatie Domain/Admin_UserName/User_UserName voor het UserName -kenmerk in het CSV-bestand. Stel dat u e-mail migreert van Exchange voor Terry Adams, Ann Beebe en Paul Cannon. U hebt een e-mailbeheerdersaccount, waarbij de gebruikersnaam mailadmin is en het wachtwoord is P@ssw0rd. Het CSV-bestand ziet er dan als volgt uit:
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:
Voor IMAP-servers die ondersteuning bieden voor Simple Authentication and Security Layer (SASL), zoals een Dovecot IMAP-server, gebruikt u de indeling User_UserName*Admin_UserName, waarbij het sterretje ( * ) een configureerbaar scheidingsteken is. Stel dat u de e-mail van diezelfde gebruikers migreert vanaf een Dovecot IMAP-server met behulp van de beheerdersreferenties mailadmin en P@ssw0rd. Het CSV-bestand ziet er dan als volgt uit:
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:
Als u e-mail migreert van Mirapoint Message Server, gebruikt u de notatie #user@domain#Admin_UserName# voor de beheerdersreferenties. Als u e-mail wilt migreren van Mirapoint met behulp van de beheerdersreferenties mailadmin en P@ssw0rd, ziet uw CSV-bestand er als volgt uit:
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:
Sommige bron-e-mailsystemen, zoals Courier IMAP, bieden geen ondersteuning voor het gebruik van postvakbeheerdersreferenties voor het migreren van postvakken naar Microsoft 365. In plaats daarvan kunt u het bron-e-mailsysteem instellen voor het gebruik van virtuele gedeelde mappen. Met behulp van virtuele gedeelde mappen kunt u de referenties van de postvakbeheerder gebruiken om toegang te krijgen tot postvakken van gebruikers in het bron-e-mailsysteem. Zie Gedeelde mappen voor meer informatie over het configureren van virtuele gedeelde mappen voor Courier IMAP.
Als u postvakken wilt migreren nadat u virtuele gedeelde mappen in het bron-e-mailsysteem hebt ingesteld, moet u het optionele kenmerk UserRoot opnemen in het migratiebestand. Dit kenmerk bevat de locatie van het postvak van elke gebruiker in de structuur van virtuele gedeelde mappen op het bron-e-mailsysteem. Het pad naar het postvak van Terry is bijvoorbeeld /users/terry.adams.
Hier volgt een voorbeeld van een CSV-bestand dat het kenmerk UserRoot bevat:
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
Stap 3: een IMAP-migratie-eindpunt maken
Als u e-mail wilt migreren, moet Microsoft 365 verbinding maken met en communiceren met het bron-e-mailsysteem. Hiervoor gebruikt Microsoft 365 een migratie-eindpunt. Het migratie-eindpunt definieert ook het aantal postvakken dat tegelijkertijd moet worden gemigreerd en het aantal postvakken dat tegelijkertijd moet worden gesynchroniseerd tijdens incrementele synchronisatie, die eens in de 24 uur plaatsvindt. Als u een migratie-eindpunt voor IMAP-migratie wilt maken, maakt u eerst verbinding met Exchange Online.
Zie Cmdlets verplaatsen en migreren voor een volledige lijst met migratieopdrachten.
Voer de volgende opdracht uit om het IMAP-migratie-eindpunt met de naam IMAPEndpoint te maken in Exchange Online PowerShell:
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 993 -Security Ssl
U kunt ook parameters toevoegen om gelijktijdige migraties, gelijktijdige incrementele migraties en de poort op te geven die u wilt gebruiken. Met de volgende Exchange Online PowerShell-opdracht maakt u een IMAP-migratie-eindpunt met de naam IMAPEndpoint dat ondersteuning biedt voor 50 gelijktijdige migraties en maximaal 25 gelijktijdige incrementele synchronisaties. Ook wordt het eindpunt geconfigureerd voor het gebruik van poort 143 voor TLS-versleuteling.
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations
50 -MaxConcurrentIncrementalSyncs 25
Zie New-MigrationEndpoint voor meer informatie over de cmdletNew-MigrationEndpoint.
Controleren of het heeft gewerkt
Voer de volgende opdracht uit in Exchange Online PowerShell om informatie over het IMAPEndpoint weer te geven:
Get-MigrationEndpoint IMAPEndpoint | Format-List EndpointType,RemoteServer,Port,Security,Max*
Stap 4: een IMAP-migratiebatch maken en starten
U kunt de cmdlet New-MigrationBatch gebruiken om een migratiebatch te maken voor een IMAP-migratie. U kunt een migratiebatch maken en deze automatisch starten door de parameter AutoStart op te geven. U kunt ook de migratiebatch maken en deze daarna starten met behulp van decmdlet Start-MigrationBatch .
Met de volgende Exchange Online PowerShell-opdracht wordt de migratiebatch met de naam IMAPBatch1 automatisch gestart met behulp van het IMAP-eindpunt met de naam IMAPEndpoint:
New-MigrationBatch -Name IMAPBatch1 -SourceEndpoint IMAPEndpoint -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -AutoStart
Controleren of het heeft gewerkt
Voer de cmdlet Get-MigrationBatch uit om informatie weer te geven over 'IMAPBatch1':
Get-MigrationBatch -Identity IMAPBatch1 | Format-List
U kunt ook controleren of de batch is gestart door de volgende opdracht uit te voeren:
Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status
Stap 5: uw e-mail routeren naar Microsoft 365
E-mailsystemen gebruiken een DNS-record, een zogenaamde MX-record, om te achterhalen waar e-mails moeten worden bezorgd. Tijdens het e-mailmigratieproces wijst de MX-record naar het bron-e-mailsysteem. Nu de e-mailmigratie naar Microsoft 365 is voltooid, is het tijd om uw MX-record te verwijzen naar Microsoft 365. Zo zorgt u ervoor dat e-mail wordt bezorgd in uw Microsoft 365-postvakken. Door de MX-record te verplaatsen, kunt u ook uw oude e-mailsysteem uitschakelen wanneer u klaar bent.
Veel DNS-providers hebben specifieke instructies voor het wijzigen van uw MX-record. Voor het geval uw DNS-provider niet is opgenomen of als u een idee wilt krijgen van de algemene richtlijnen, worden ook de algemene instructies voor MX-records verstrekt.
Het kan tot 72 uur duren voordat in de e-mailsystemen van uw klanten en partners de gewijzigde MX-record wordt herkend. Wacht ten minste 72 uur voordat u doorgaat met de volgende taak: Stap 6: IMAP-migratiebatch verwijderen.
Stap 6: IMAP-migratiebatch verwijderen
Nadat u de MX-record hebt gewijzigd en hebt gecontroleerd of alle e-mail wordt doorgestuurd naar Microsoft 365-postvakken, meldt u de gebruikers dat hun e-mail naar Microsoft 365 gaat. Hierna kunt u de IMAP-migratiebatch verwijderen. Controleer het volgende voordat u de migratiebatch verwijdert.
Alle gebruikers gebruiken Microsoft 365-postvakken. Nadat de batch is verwijderd, wordt e-mail die wordt verzonden naar postvakken op de on-premises Exchange Server niet gekopieerd naar de bijbehorende Microsoft 365-postvakken.
Microsoft 365-postvakken zijn minstens één keer gesynchroniseerd nadat e-mail rechtstreeks naar hen is verzonden. Om dit te doen, moet u ervoor zorgen dat de waarde in het vak Laatst gesynchroniseerde tijd voor de migratiebatch recenter is dan wanneer e-mail rechtstreeks naar Microsoft 365-postvakken werd gerouteerd.
Voer de volgende opdracht uit om de migratiebatch 'IMAPBatch1' uit Exchange Online PowerShell te verwijderen:
Remove-MigrationBatch -Identity IMAPBatch1
Zie Remove-MigrationBatch voor meer informatie over de cmdletRemove-MigrationBatch.
Controleren of het heeft gewerkt
Voer de volgende opdracht uit in Exchange Online PowerShell om informatie over de 'IMAPBatch1' weer te geven:
Get-MigrationBatch IMAPBatch1"
De opdracht retourneert de migratiebatch met de status Verwijderen of retourneert een fout waarin wordt aangegeven dat de migratiebatch niet kan worden gevonden, waarbij wordt gecontroleerd of de batch is verwijderd.
Zie Get-MigrationBatch voor meer informatie over de cmdletGet-MigrationBatch.