Använda PowerShell för att utföra en IMAP-migrering till Microsoft 365
Denna artikel gäller för både Microsoft 365 Enterprise och Office 365 Enterprise.
Som en del av distributionen av Microsoft 365 kan du välja att migrera innehållet i användarpostlådor från en E-posttjänst för Internet Mail Access Protocol (IMAP) till Microsoft 365. Den här artikeln vägleder dig genom uppgifterna för en IMAP-migrering via e-post med hjälp av Exchange Online PowerShell.
Obs!
Du kan också använda administrationscentret för Exchange för att utföra en IMAP-migrering. Se Migrera dina IMAP-postlådor.
Vad behöver jag veta innan jag börjar?
Uppskattad tid för att slutföra den här uppgiften: 2–5 minuter för att skapa en migreringsbatch. När migreringsbatchen har startats varierar migreringens varaktighet beroende på antalet postlådor i batchen, storleken på varje postlåda och din tillgängliga nätverkskapacitet. Information om andra faktorer som påverkar hur lång tid det tar att migrera postlådor till Microsoft 365 finns i Migreringsprestanda.
Du måste ha tilldelats behörigheter för att kunna utföra den här proceduren eller procedurerna. Om du vill se vilka behörigheter du behöver kan du läsa posten "Migrering" i en tabell i artikeln Mottagarbehörigheter .
Om du vill använda Exchange Online PowerShell-cmdletar måste du logga in och importera cmdletarna till din lokala Windows PowerShell session. Anvisningar finns i Ansluta till Exchange Online PowerShell.
En fullständig lista över migreringskommandon finns i Flytta och migrera cmdletar.
Följande begränsningar gäller för IMAP-migreringar:
Endast objekt i en användares inkorg eller andra e-postmappar kan migreras. Du kan inte migrera kontakter, kalenderobjekt eller uppgifter.
Högst 500 000 objekt kan migreras från en användares postlåda.
Den maximala meddelandestorleken som kan migreras är 35 MB.
Migreringssteg
Steg 1: Förbereda för en IMAP-migrering
Om du har en domän för din IMAP-organisation lägger du till den som en godkänd domän i din Microsoft 365-organisation. Om du vill använda samma domän som du redan äger för dina Microsoft 365-postlådor måste du först lägga till den som en godkänd domän i Microsoft 365. När du har lagt till den kan du skapa dina användare i Microsoft 365. Mer information finns iVerifiera din domän.
Lägg till varje användare i Microsoft 365 så att de har en postlåda. Anvisningar finns iLägga till användare i Microsoft 365 för företag.
Hämta FQDN för IMAP-servern. Du måste ange det fullständigt kvalificerade domännamnet (FQDN) (även kallat det fullständiga datornamnet) för den IMAP-server som du ska migrera postlådedata från när du skapar en slutpunkt för IMAP-migrering. Använd en IMAP-klient eller kommandot PING och kontrollera att du kan använda det fullständiga domännamnet för att kommunicera med IMAP-servern över Internet.
Konfigurera brandväggen för att tillåta IMAP-anslutningar. Du kan behöva öppna portar i brandväggen för den organisation som är värd för IMAP-servern så att nätverkstrafik från Microsofts datacenter under migreringen tillåts att komma in i den organisation som är värd för IMAP-servern. En lista över IP-adresser som används av Microsofts datacenter finns i Exchange Online URL:er och IP-adressintervall.
Tilldela administratörskontobehörigheter för åtkomst till postlådor i din IMAP-organisation. Om du använder administratörsautentiseringsuppgifter i CSV-filen måste det konto som du använder ha nödvändig åtkomstbehörighet till de lokala postlådorna. De behörigheter som krävs för att komma åt användarpostlådor bestäms av den specifika IMAP-servern.
Om du vill använda Exchange Online PowerShell-cmdletar måste du logga in och importera cmdletarna till din lokala Windows PowerShell session. Anvisningar finns i Ansluta till Exchange Online PowerShell.
En fullständig lista över migreringskommandon finns i Flytta och migrera cmdletar.
Kontrollera att du kan ansluta till din IMAP-server. Kör följande kommando i Exchange Online PowerShell för att testa anslutningsinställningarna till IMAP-servern.
Test-MigrationServerAvailability -IMAP -RemoteServer <FQDN of IMAP server> -Port <143 or 993> -Security <None, Ssl, or Tls>För värdet för portparametern är det vanligt att använda 143 för Okrypterade anslutningar eller TLS-anslutningar (Transport Layer Security) och att använda 993 för SSL-anslutningar.
Steg 2: Skapa en CSV-fil för en IMAP-migreringsbatch
Identifiera den grupp av användare vars postlådor du vill migrera i en IMAP-migreringsbatch. Varje rad i CSV-filen innehåller information som behövs för att ansluta till en postlåda i IMAP-meddelandesystemet.
Här är de obligatoriska attributen för varje användare:
EmailAddress anger användar-ID för användarens Microsoft 365-postlåda.
UserName anger inloggningsnamnet för kontot som ska användas för att komma åt postlådan på IMAP-servern.
Lösenordet anger lösenordet för kontot i kolumnen Användarnamn .
Här följer ett exempel på CSV-filens format. I det här exemplet migreras tre postlådor:
EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams,1091990
annb@contoso.edu,ann.beebe,2111991
paulc@contoso.edu,paul.cannon,3281986
För attributet UserName kan du utöver användarnamnet använda autentiseringsuppgifterna för ett konto som har tilldelats de behörigheter som krävs för att komma åt postlådor på IMAP-servern. Följande är några av de specifika format som används för vissa av IMAP-servrarna:
Microsoft Exchange:
Om du migrerar e-post från IMAP-implementeringen för Microsoft Exchange använder du formatet Domain/Admin_UserName/User_UserName för attributet UserName i CSV-filen. Säg att du migrerar e-post från Exchange för Terry Adams, Ann Beebe och Paul Cannon. Du har ett e-postadministratörskonto där användarnamnet är mailadmin och lösenordet är P@ssw0rd. Så här skulle CSV-filen se ut:
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:
För IMAP-servrar som stöder SASL (Simple Authentication and Security Layer), till exempel en Dovecot IMAP-server, använder du formatet User_UserName*Admin_UserName, där asterisken ( * ) är ett konfigurerbart avgränsartecken. Anta att du migrerar samma användares e-post från en Dovecot IMAP-server med administratörsuppgifterna mailadmin och P@ssw0rd. Så här skulle CSV-filen se ut:
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:
Om du migrerar e-post från Mirapoint Message Server använder du formatet #user@domain#Admin_UserName# för administratörsautentiseringsuppgifterna. Om du vill migrera e-post från Mirapoint med administratörsautentiseringsuppgifterna mailadmin och P@ssw0rd ser CSV-filen ut så här:
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
IMAP-kurir:
Vissa käll-e-postsystem, till exempel Courier IMAP, stöder inte användning av administratörsautentiseringsuppgifter för postlådor för att migrera postlådor till Microsoft 365. I stället kan du konfigurera käll-e-postsystemet till att använda virtuella delade mappar. Med hjälp av virtuella delade mappar kan du använda autentiseringsuppgifterna för postlådans administratör för att komma åt användarpostlådor i käll-e-postsystemet. Mer information om hur du konfigurerar virtuella delade mappar för Courier IMAP finns i Delade mappar.
Om du vill migrera postlådor när du har konfigurerat virtuella delade mappar på ditt käll-e-postsystem måste du ta med det valfria attributet UserRoot i migreringsfilen. Attributet anger platsen för varje användares postlåda i strukturen med virtuella delade mappar på käll-e-postsystemet. Sökvägen till Terrys postlåda är till exempel /users/terry.adams.
Här är ett exempel på en CSV-fil som innehåller attributet UserRoot:
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
Steg 3: Skapa en slutpunkt för IMAP-migrering
För att kunna migrera e-post måste Microsoft 365 ansluta till och kommunicera med källans e-postsystem. För att göra detta använder Microsoft 365 en migreringsslutpunkt. Slutpunkten för migrering definierar också antalet postlådor som ska migreras samtidigt och antalet postlådor som ska synkroniseras samtidigt under inkrementell synkronisering, vilket sker en gång var 24:e timme. Om du vill skapa en migreringsslutpunkt för IMAP-migrering ansluter du först till Exchange Online.
En fullständig lista över migreringskommandon finns i Flytta och migrera cmdletar.
Kör följande kommando för att skapa IMAP-migreringsslutpunkten "IMAPEndpoint" i Exchange Online PowerShell:
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 993 -Security Ssl
Du kan också lägga till parametrar för att ange samtidiga migreringar, samtidiga inkrementella migreringar och porten som ska användas. Följande Exchange Online PowerShell-kommando skapar en IMAP-migreringsslutpunkt med namnet "IMAPEndpoint" som stöder 50 samtidiga migreringar och upp till 25 samtidiga inkrementella synkroniseringar. Den konfigurerar också slutpunkten för att använda port 143 för TLS-kryptering.
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations
50 -MaxConcurrentIncrementalSyncs 25
Mer information om cmdleten New-MigrationEndpoint finns iNew-MigrationEndpoint.
Kontrollera att det fungerade
Kör följande kommando i Exchange Online PowerShell för att visa information om "IMAPEndpoint":
Get-MigrationEndpoint IMAPEndpoint | Format-List EndpointType,RemoteServer,Port,Security,Max*
Steg 4: Skapa och starta en IMAP-migreringsbatch
Du kan använda cmdleten New-MigrationBatch för att skapa en migreringsbatch för en IMAP-migrering. Du kan skapa en migreringsbatch och starta den automatiskt genom att inkludera parametern AutoStart . Du kan också skapa migreringsbatchen och sedan starta den efteråt med hjälp av cmdletenStart-MigrationBatch .
Följande Exchange Online PowerShell-kommando startar automatiskt migreringsbatchen "IMAPBatch1" med hjälp av IMAP-slutpunkten "IMAPEndpoint":
New-MigrationBatch -Name IMAPBatch1 -SourceEndpoint IMAPEndpoint -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -AutoStart
Kontrollera att det fungerade
Kör cmdleten Get-MigrationBatch för att visa information om "IMAPBatch1":
Get-MigrationBatch -Identity IMAPBatch1 | Format-List
Du kan också kontrollera att batchen har startats genom att köra följande kommando:
Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status
Steg 5: Dirigera din e-post till Microsoft 365
Email systems use a DNS record called an MX record to figure out where to deliver emails. Under e-postmigreringen pekade MX-posten på källans e-postsystem. Nu när e-postmigreringen till Microsoft 365 är klar är det dags att peka din MX-post på Microsoft 365. På så sätt ser du till att e-post levereras till dina Microsoft 365-postlådor. Genom att flytta MX-posten kan du också stänga av ditt gamla e-postsystem när du är klar.
För många DNS-leverantörer finns det särskilda anvisningar för hur du ändrar MX-posten. Om din DNS-värd inte finns med eller om du bara allmänt vill se hur anvisningarna ser ut, finns det även allmänna anvisningar för MX-posten.
Det kan ta upp till 72 timmar för kunders och partners e-postsystem att se den ändrade MX-posten. Vänta minst 72 timmar innan du fortsätter till nästa uppgift: Steg 6: Ta bort IMAP-migreringsbatch.
Steg 6: Ta bort IMAP-migreringsbatch
När du har ändrat MX-posten och kontrollerat att all e-post dirigeras till Microsoft 365-postlådor meddelar du användarna att deras e-post kommer till Microsoft 365. Därefter kan du ta bort IMAP-migreringsbatchen. Kontrollera följande innan du tar bort migreringsbatchen.
Alla användare använder Microsoft 365-postlådor. När batchen har tagits bort kopieras inte e-post som skickas till postlådor lokalt Exchange Server till motsvarande Microsoft 365-postlådor.
Microsoft 365-postlådor synkroniserades minst en gång efter att e-post började skickas direkt till dem. Det gör du genom att kontrollera att värdet i rutan Senast synkroniserad tid för migreringsbatchen är nyare än när e-post började dirigeras direkt till Microsoft 365-postlådor.
Om du vill ta bort migreringsbatch-batchen "IMAPBatch1" från Exchange Online PowerShell kör du följande kommando:
Remove-MigrationBatch -Identity IMAPBatch1
Mer information om cmdleten Remove-MigrationBatch finns iRemove-MigrationBatch.
Kontrollera att det fungerade
Kör följande kommando i Exchange Online PowerShell för att visa information om "IMAPBatch1":
Get-MigrationBatch IMAPBatch1"
Kommandot returnerar antingen migreringsbatchen med statusen Ta bort, eller så returneras ett fel som anger att migreringsbatch inte kunde hittas, vilket verifierar att batchen har tagits bort.
Mer information om cmdleten Get-MigrationBatch finns iGet-MigrationBatch.