Bruke PowerShell til å utføre en IMAP-overføring til Microsoft 365
Denne artikkelen gjelder for både Microsoft 365 Enterprise og Office 365 Enterprise.
Som en del av prosessen med å distribuere Microsoft 365, kan du velge å overføre innholdet i brukerpostbokser fra en IMAP-e-posttjeneste (Internet Mail Access Protocol) til Microsoft 365. Denne artikkelen veileder deg gjennom oppgavene for en e-post-IMAP-overføring ved hjelp av Exchange Online PowerShell.
Obs!
Du kan også bruke administrasjonssenteret for Exchange til å utføre en IMAP-overføring. Se Overføre IMAP-postboksene.
Hva må du vite før du begynner?
Beregnet tid for å fullføre denne oppgaven: 2–5 minutter til å opprette en overføringsgruppe. Når overføringsgruppen er startet, varierer varigheten av overføringen basert på antall postbokser i overføringsgruppen, størrelsen på hver postboks og den tilgjengelige nettverkskapasiteten. Hvis du vil ha informasjon om andre faktorer som påvirker hvor lang tid det tar å overføre postbokser til Microsoft 365, kan du se Overføringsytelse.
Du må være tilordnet tillatelser før du kan utføre prosedyren eller prosedyrene. Hvis du vil se hvilke tillatelser du trenger, kan du se oppføringen «Overføring» i en tabell i artikkelen Mottakeretillatelser .
Hvis du vil bruke Exchange Online PowerShell-cmdleter, må du logge på og importere cmdletene til den lokale Windows PowerShell økten. Se Koble til Exchange Online PowerShell for instruksjoner.
Hvis du vil ha en fullstendig liste over overføringskommandoer, kan du se Cmdleter for flytting og overføring.
Følgende begrensninger gjelder for IMAP-overføringer:
Bare elementer i en brukers innboks eller andre e-postmapper kan overføres. Du kan ikke overføre kontakter, kalenderelementer eller oppgaver.
Maksimalt 500 000 elementer kan overføres fra en brukers postboks.
Den maksimale meldingsstørrelsen som kan overføres, er 35 MB.
Overføringstrinn
Trinn 1: Klargjøre for en IMAP-overføring
Hvis du har et domene for IMAP-organisasjonen, kan du legge det til som et godtatt domene i Microsoft 365-organisasjonen. Hvis du vil bruke det samme domenet du allerede eier for Microsoft 365-postboksene, må du først legge det til som et godtatt domene i Microsoft 365. Når du har lagt den til, kan du opprette brukerne i Microsoft 365. Hvis du vil ha mer informasjon,kan du se Bekrefte domenet.
Legg til hver bruker i Microsoft 365 slik at de har en postboks. Hvis du vil ha instruksjoner, kan du seLegge til brukere i Microsoft 365 for bedrifter.
Hent FQDN for IMAP-serveren. Du må oppgi det fullstendige domenenavnet (FQDN) (også kalt det fullstendige datamaskinnavnet) til IMAP-serveren som du skal overføre postboksdata fra når du oppretter et IMAP-overføringsendepunkt. Bruk en IMAP-klient eller PING-kommandoen til å finne ut om du kan bruke FQDN til å kommunisere med IMAP-serveren over Internett.
Konfigurer brannmuren til å tillate IMAP-tilkoblinger. Du må kanskje åpne porter i brannmuren til organisasjonen som er vert for IMAP-serveren, slik at nettverkstrafikk som kommer fra Microsoft-datasenteret under overføringen, har tillatelse til å gå inn i organisasjonen som er vert for IMAP-serveren. Hvis du vil ha en liste over IP-adresser som brukes av Microsoft-datasentre, kan du se Exchange Online nettadresser og IP-adresseområder.
Tilordne administratorkontotillatelser for å få tilgang til postbokser i IMAP-organisasjonen. Hvis du bruker administratorlegitimasjon i CSV-filen, må kontoen du bruker, ha tillatelsene som kreves for å få tilgang til de lokale postboksene. Tillatelsene som kreves for å få tilgang til brukerpostbokser, bestemmes av den bestemte IMAP-serveren.
Hvis du vil bruke Exchange Online PowerShell-cmdleter, må du logge på og importere cmdletene til den lokale Windows PowerShell økten. Se Koble til Exchange Online PowerShell for instruksjoner.
Hvis du vil ha en fullstendig liste over overføringskommandoer, kan du se Cmdleter for flytting og overføring.
Kontroller at du kan koble til IMAP-serveren. Kjør følgende kommando i Exchange Online PowerShell for å teste tilkoblingsinnstillingene til IMAP-serveren.
Test-MigrationServerAvailability -IMAP -RemoteServer <FQDN of IMAP server> -Port <143 or 993> -Security <None, Ssl, or Tls>For verdien til portparameteren er det vanlig å bruke 143 for ukrypterte tilkoblinger eller TLS-tilkoblinger (Transport Layer Security) og til å bruke 993 for SSL-tilkoblinger.
Trinn 2: Opprett en CSV-fil for en IMAP-overføringsgruppe
Identifiser gruppen med brukere som har postbokser du vil overføre i en IMAP-overføringsgruppe. Hver rad i CSV-filen inneholder informasjon som er nødvendig for å koble til en postboks i IMAP-meldingssystemet.
Dette er de nødvendige attributtene for hver bruker:
EmailAddress angir bruker-ID-en for brukerens Microsoft 365-postboks.
Brukernavn angir påloggingsnavnet for kontoen som skal brukes til å få tilgang til postboksen på IMAP-serveren.
Passordet angir passordet for kontoen i UserName-kolonnen .
Her er et eksempel på format for CSV-filen. I dette eksemplet overføres tre postbokser:
EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams,1091990
annb@contoso.edu,ann.beebe,2111991
paulc@contoso.edu,paul.cannon,3281986
For UserName-attributtet , i tillegg til brukernavnet, kan du bruke legitimasjonen for en konto som har fått de nødvendige tillatelsene til å få tilgang til postbokser på IMAP-serveren, følgende er noen av de spesifikke formatene som brukes for noen av IMAP-serverne:
Microsoft Exchange:
Hvis du vil overføre e-post fra IMAP-implementeringen for Microsoft Exchange, bruker du formatet Domain/Admin_UserName/User_UserName for UserName -attributtet i CSV-filen. La oss si at du skal overføre e-post fra Exchange for Terry Adams, Ann Beebe og Paul Cannon. Du har en e-postadministratorkonto der brukernavnet er mailadmin og passordet er P@ssw0rd. Slik ville CSV-filen sett 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:
For IMAP-servere som støtter SASL (Simple Authentication and Security Layer), for eksempel en Dovecot IMAP-server, bruker du formatet User_UserName*Admin_UserName, der stjernen ( * ) er et konfigurerbart skilletegn. La oss si at du overfører de samme brukernes e-post fra en Dovecot IMAP-server ved hjelp av administratorlegitimasjons-e-postadministratoren og P@ssw0rd. Slik ville CSV-filen sett 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:
Hvis du vil overføre e-post fra Mirapoint Message Server, bruker du formatet #user@domain#Admin_UserName# for administratorlegitimasjonen. Hvis du vil overføre e-post fra Mirapoint ved hjelp av administratorlegitimasjonspostadministratoren og P@ssw0rd, vil CSV-filen se slik ut:
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:
Noen kilde-e-postsystemer, for eksempel Courier IMAP, støtter ikke bruk av postboksadministratorlegitimasjon til å overføre postbokser til Microsoft 365. Du kan i stedet konfigurere kilde-e-postsystemet slik at det bruker virtuelle delte mapper. Ved hjelp av virtuelle delte mapper kan du bruke administratorlegitimasjonen for postboksen til å få tilgang til brukerpostbokser i kilde-e-postsystemet. Hvis du vil ha mer informasjon om hvordan du konfigurerer virtuelle delte mapper for Courier IMAP, kan du se Delte mapper.
Hvis du vil overføre postbokser etter at du har konfigurert virtuelle delte mapper på kilde-e-postsystemet, må du ta med det valgfrie attributtet UserRoot i overføringsfilen. Dette attributtet angir plasseringen til hver brukers postboks i den virtuelle delte mappestrukturen på kilde-e-postsystemet. Banen til Terrys postboks er for eksempel /brukere/terry.adams.
Her er et eksempel på en CSV-fil som inneholder UserRoot -attributtet:
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
Trinn 3: Opprette et IMAP-overføringsendepunkt
Microsoft 365 må koble til og kommunisere med kilde-e-postsystemet for å kunne overføre e-post. For å gjøre dette bruker Microsoft 365 et overføringsendepunkt. Overføringsendepunktet definerer også antall postbokser som skal overføres samtidig, og antall postbokser som skal synkroniseres samtidig under trinnvis synkronisering, som skjer én gang hver 24. time. Hvis du vil opprette et overføringsendepunkt for IMAP-overføring, må du først koble til Exchange Online.
Hvis du vil ha en fullstendig liste over overføringskommandoer, kan du se Cmdleter for flytting og overføring.
Hvis du vil opprette IMAP-overføringsendepunktet kalt IMAPEndpoint i Exchange Online PowerShell, kjører du følgende kommando:
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 993 -Security Ssl
Du kan også legge til parametere for å angi samtidige overføringer, samtidige trinnvise overføringer og porten som skal brukes. Følgende Exchange Online PowerShell-kommando oppretter et IMAP-overføringsendepunkt kalt «IMAPEndpoint» som støtter 50 samtidige overføringer og opptil 25 samtidige trinnvise synkroniseringer. Det konfigurerer også endepunktet til å bruke port 143 for TLS-kryptering.
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations
50 -MaxConcurrentIncrementalSyncs 25
Hvis du vil ha mer informasjon om cmdleten New-MigrationEndpoint , kan du seNew-MigrationEndpoint.
Kontroller at det fungerte
Kjør følgende kommando i Exchange Online PowerShell for å vise informasjon om IMAPEndpoint:
Get-MigrationEndpoint IMAPEndpoint | Format-List EndpointType,RemoteServer,Port,Security,Max*
Trinn 4: Opprette og starte en IMAP-overføringsgruppe
Du kan bruke cmdleten New-MigrationBatch til å opprette en overføringsgruppe for en IMAP-overføring. Du kan opprette en overføringsgruppe og starte den automatisk ved å inkludere AutoStart-parameteren. Du kan også opprette overføringsgruppen og deretter starte den etterpå ved hjelp avcmdleten Start-MigrationBatch .
Følgende Exchange Online PowerShell-kommando starter automatisk overføringsgruppen kalt IMAPBatch1 ved hjelp av IMAP-endepunktet kalt IMAPEndpoint:
New-MigrationBatch -Name IMAPBatch1 -SourceEndpoint IMAPEndpoint -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -AutoStart
Kontroller at det fungerte
Kjør cmdleten Get-MigrationBatch for å vise informasjon om IMAPBatch1:
Get-MigrationBatch -Identity IMAPBatch1 | Format-List
Du kan også kontrollere at overføringsgruppen har startet ved å kjøre følgende kommando:
Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status
Trinn 5: Rute e-posten til Microsoft 365
Email systems use a DNS record called an MX record to figure out where to deliver emails. Under e-postoverføringsprosessen pekte MX-posten til kilde-e-postsystemet. Nå som e-postoverføringen til Microsoft 365 er fullført, er det på tide å peke MX-posten til Microsoft 365. Dette bidrar til å sikre at e-post leveres til Microsoft 365-postboksene. Ved å flytte MX-posten kan du også slå av det gamle e-postsystemet når du er klar.
Det finnes spesifikke instruksjoner for å endre MX-posten for mange DNS-leverandører. Hvis DNS-leverandøren ikke er inkludert, eller hvis du vil få en oversikt over de generelle instruksjonene, gis også generelle MX-postinstruksjoner .
Det kan ta opptil 72 timer før e-postsystemene til kundene og partnerne dine registrerer den endrede MX-posten. Vent minst 72 timer før du fortsetter til neste oppgave: Trinn 6: Slett IMAP-overføringsgruppe.
Trinn 6: Slett IMAP-overføringsgruppe
Når du har endret MX-posten og bekreftet at all e-post rutes til Microsoft 365-postbokser, må du varsle brukerne om at e-posten deres går til Microsoft 365. Etter dette kan du slette IMAP-overføringsgruppen. Kontroller følgende før du sletter overføringsgruppen.
Alle brukere bruker Microsoft 365-postbokser. Når overføringsgruppen er slettet, kopieres ikke e-post som sendes til postbokser lokalt Exchange Server til de tilsvarende Microsoft 365-postboksene.
Microsoft 365-postbokser ble synkronisert minst én gang etter at e-post ble sendt direkte til dem. Hvis du vil gjøre dette, må du kontrollere at verdien i boksen Sist synkronisert tid for overføringsgruppen er nyere enn da e-post begynte å rutes direkte til Microsoft 365-postbokser.
Hvis du vil slette «IMAPBatch1»-overføringsgruppen fra Exchange Online PowerShell, kjører du følgende kommando:
Remove-MigrationBatch -Identity IMAPBatch1
Hvis du vil ha mer informasjon om cmdleten Remove-MigrationBatch , kan du seRemove-MigrationBatch.
Kontroller at det fungerte
Kjør følgende kommando i Exchange Online PowerShell for å vise informasjon om IMAPBatch1:
Get-MigrationBatch IMAPBatch1"
Kommandoen returnerer enten overføringsgruppen med statusen Removing, eller den vil returnere en feil som sier at overføringsgruppen ikke ble funnet, og bekrefter at overføringsgruppen ble slettet.
Hvis du vil ha mer informasjon om Get-MigrationBatch-cmdleten , kan du seGet-MigrationBatch.