Usar o PowerShell para realizar uma migração IMAP para o Microsoft 365
Esse artigo se aplica ao Microsoft 365 Enterprise e ao Office 365 Enterprise.
Como parte do processo de implementação do Microsoft 365, pode optar por migrar o conteúdo das caixas de correio de utilizadores de um serviço de e-mail IMAP (Internet Mail Access Protocol) para o Microsoft 365. Este artigo apresenta as tarefas para uma migração IMAP de email usando o PowerShell do Exchange Online.
Observação
Também pode utilizar o Centro de administração do Exchange para efetuar uma migração IMAP. Consulte Migrar as suas caixas de correio IMAP.
Do que você precisa saber para começar?
Tempo estimado para a conclusão da tarefa: 2-5 minutos para criar um lote de migração. Depois que o lote de migração é iniciado, a duração da migração irá variar com base no número de caixas de correio no lote, no tamanho de cada caixa de correio e na sua capacidade de rede disponível. Para obter informações sobre outros fatores que afetam o tempo que demora a migrar caixas de correio para o Microsoft 365, consulte Desempenho da Migração.
Para executar este procedimento ou estes procedimentos, você precisa receber permissões. Para ver que permissões precisa, veja a entrada "Migração" numa tabela no artigo Permissões de Destinatários .
Para utilizar os cmdlets do Exchange Online PowerShell, tem de iniciar sessão e importar os cmdlets para a sua sessão de Windows PowerShell local. Veja Ligar ao Exchange Online PowerShell para obter instruções.
Para obter uma lista completa dos comandos de migração, confira Cmdlets de movimentação e migração.
As seguintes restrições se aplicam às migrações IMAP:
Apenas itens na caixa de entrada de um usuário ou outras pastas de email pode ser migradas. Não pode migrar contactos, itens de calendário ou tarefas.
No máximo 500.000 itens podem ser migrados de uma caixa de correio de usuário.
O tamanho máximo da mensagem que pode ser migrada é de 35 MB.
Etapas da migração
Etapa 1: Preparar uma migração IMAP
Se tiver um domínio para a sua organização IMAP, adicione-o como um domínio aceite da sua organização do Microsoft 365. Se quiser utilizar o mesmo domínio que já possui para as suas caixas de correio do Microsoft 365, primeiro tem de adicioná-lo como um domínio aceite ao Microsoft 365. Depois de o adicionar, pode criar os seus utilizadores no Microsoft 365. Para obter mais informações, vejaVerificar o seu domínio.
Adicione cada utilizador ao Microsoft 365 para que tenha uma caixa de correio. Para obter instruções, consulteAdicionar utilizadores ao Microsoft 365 para empresas.
Obter o FQDN do servidor IMAP. Tem de fornecer o nome de domínio completamente qualificado (FQDN) (também denominado nome completo do computador) do servidor IMAP a partir do qual irá migrar os dados da caixa de correio quando criar um ponto final de migração IMAP. Use um cliente IMAP ou o comando PING para verificar se você pode usar o FQDN para se comunicar com o servidor IMAP pela Internet.
Configurar o firewall para permitir conexões IMAP. Você pode precisar abrir portas no firewall da organização que hospeda o servidor IMAP para que o tráfego de rede originário do data center da Microsoft durante a migração tenha permissão para entrar na organização que hospeda o servidor IMAP. Para obter uma lista dos endereços IP utilizados pelos datacenters da Microsoft, veja EXCHANGE ONLINE URLs e Intervalos de Endereços IP.
Atribuir ao administrador permissões de conta para acessar caixas de correio em sua organização IMAP Se você usar credenciais de administrador no arquivo CSV, a conta usada deverá ter as permissões necessárias para acessar as caixas de correio locais. As permissões necessárias para acessar as caixas de correio do usuário são determinadas pelo servidor IMAP específico.
Para utilizar os cmdlets do Exchange Online PowerShell, tem de iniciar sessão e importar os cmdlets para a sua sessão de Windows PowerShell local. Veja Ligar ao Exchange Online PowerShell para obter instruções.
Para obter uma lista completa dos comandos de migração, confira Cmdlets de movimentação e migração.
Verifique se você pode se conectar ao servidor IMAP. Execute o seguinte comando no PowerShell do Exchange Online para testar as configurações de conexão ao servidor IMAP.
Test-MigrationServerAvailability -IMAP -RemoteServer <FQDN of IMAP server> -Port <143 or 993> -Security <None, Ssl, or Tls>Para o valor do parâmetro Port, é normal usar 143 para conexões descriptografadas ou TLS (Transport Layer Security) e usar 993 para conexões SSL.
Etapa 2: Criar um arquivo CSV para um lote de migração IMAP
Identifique o grupo de usuários cujas caixas de correio você deseja migrar em um lote de migração IMAP. Cada linha no arquivo CSV contém as informações necessárias para se conectar a uma caixa de correio no sistema de mensagens IMAP.
Veja a seguir os atributos necessários para cada usuário:
EmailAddress especifica o ID de utilizador da caixa de correio do Microsoft 365 do utilizador.
UserName especifica o nome de início de sessão da conta a utilizar para aceder à caixa de correio no servidor IMAP.
Password especifica a senha para a conta na coluna UserName.
Aqui está um exemplo do formato do arquivo CSV. Neste exemplo, três caixas de correio são migradas:
EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams,1091990
annb@contoso.edu,ann.beebe,2111991
paulc@contoso.edu,paul.cannon,3281986
Para o atributo UserName, além do nome de usuário, você pode usar as credenciais de uma conta que recebeu as permissões necessárias para acessar caixas de correio no servidor IMAP. A seguir estão alguns dos formatos específicos usados para alguns dos servidores IMAP:
Microsoft Exchange:
Se você estiver migrando emails da implementação de IMAP para Microsoft Exchange, use o formato Domain/Admin_UserName/User_UserName para o atributo UserName no arquivo CSV. Digamos que você esteja migrando email do Exchange para Henrique Castro, Alice Pena e Pedro Gonçalves. Tem uma conta de administrador de correio, em que o nome de utilizador é mailadmin e a palavra-passe é P@ssw0rd. Esta seria a aparência do seu arquivo CSV:
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:
Para servidores IMAP que dão suporte a SASL (Simple Authentication and Security Layer), como um servidor Dovecot IMAP, use o formato User_UserName*Admin_UserName, em que o asterisco (*) é um caractere separador configurável. Digamos que está a migrar o e-mail desses mesmos utilizadores a partir de um servidor IMAP do Dovecot com as credenciais de administrador mailadmin e P@ssw0rd. Esta seria a aparência do seu arquivo CSV:
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:
Se você estiver migrando email do Servidor de Mensagens Mirapoint, use o formato #user@domain#Admin_UserName# para as credenciais de administrador. Para migrar e-mails do Mirapoint com as credenciais de administrador mailadmin e P@ssw0rd, o ficheiro CSV terá o seguinte aspeto:
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:
Alguns sistemas de e-mail de origem, como o Courier IMAP, não suportam a utilização de credenciais de administrador de caixa de correio para migrar caixas de correio para o Microsoft 365. Em vez disso, você pode configurar seu sistema de email de origem para usar pastas compartilhadas virtuais. Usando pastas compartilhadas virtuais, você pode usar as credenciais de administrador de caixa de correio para acessar caixas de correio do usuário no sistema de email de origem. Para saber mais sobre como configurar as pastas virtuais compartilhadas do Courier IMAP, consulte Pastas Compartilhadas.
Para migrar caixas de correio após configurar as pastas virtuais compartilhadas no sistema de email de origem, é necessário incluir o atributo opcional UserRoot no arquivo da migração. Esse atributo especifica a localização da caixa de correio de cada usuário na estrutura da pasta virtual compartilhada, no sistema de email de origem. Por exemplo, o caminho para a caixa de correio de Pedro é /users/pedro.goncalves.
Aqui está um exemplo de um arquivo CSV que contém o atributo 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
Etapa 3: Criar um ponto de extremidade de migração IMAP
Para migrar o e-mail com êxito, o Microsoft 365 tem de se ligar e comunicar com o sistema de e-mail de origem. Para tal, o Microsoft 365 utiliza um ponto final de migração. O ponto de extremidade de migração também define o número de caixas de correio para migração simultânea e o número de caixas de correio para sincronização simultânea durante a sincronização incremental, que ocorre uma vez a cada 24 horas. Para criar um ponto final de migração para a migração IMAP, ligue-se primeiro ao Exchange Online.
Para obter uma lista completa dos comandos de migração, confira Cmdlets de movimentação e migração.
Para criar o ponto de extremidade de migração IMAP chamado "IMAPEndpoint" no PowerShell do Exchange Online, execute o seguinte comando:
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 993 -Security Ssl
Você também pode adicionar parâmetros para especificar migrações simultâneas, migrações simultâneas incrementais e a porta a ser usada. O comando a seguir do PowerShell do Exchange Online cria um ponto de extremidade de migração IMAP chamado "IMAPEndpoint" que dá suporte a 50 migrações simultâneas e até 25 sincronizações incrementais simultâneas. Também configura o ponto de extremidade para usar a porta 143 para criptografia TLS.
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations
50 -MaxConcurrentIncrementalSyncs 25
Para saber mais sobre o cmdlet New-MigrationEndpoint, confiraNew-MigrationEndpoint.
Verifique se funcionou
Execute o seguinte comando no PowerShell do Exchange Online para exibir informações sobre o "IMAPEndpoint":
Get-MigrationEndpoint IMAPEndpoint | Format-List EndpointType,RemoteServer,Port,Security,Max*
Etapa 4: Criar e iniciar um lote de migração IMAP
Pode utilizar o cmdlet New-MigrationBatch para criar um lote de migração para uma migração IMAP. Pode criar um lote de migração e iniciá-lo automaticamente ao incluir o parâmetro AutoStart . Em alternativa, pode criar o lote de migração e, em seguida, iniciá-lo posteriormente com o cmdletStart-MigrationBatch .
O seguinte comando do PowerShell do Exchange Online iniciará automaticamente o lote de migração chamado "IMAPBatch1" usando o ponto de extremidade IMAP chamado "IMAPEndpoint":
New-MigrationBatch -Name IMAPBatch1 -SourceEndpoint IMAPEndpoint -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -AutoStart
Verifique se funcionou
Execute o cmdlet Get-MigrationBatch para exibir informações sobre o "IMAPBatch1":
Get-MigrationBatch -Identity IMAPBatch1 | Format-List
Você também pode verificar se o lote foi iniciado executando o seguinte comando:
Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status
Passo 5: Encaminhar o seu e-mail para o Microsoft 365
Os sistemas de email usam um registro DNS chamado registro MX para descobrir onde entregar emails. Durante o processo de migração de email, seu registro MX estava apontando para o sistema de email de origem. Agora que a migração de e-mail para o Microsoft 365 está concluída, está na altura de apontar o seu registo MX para o Microsoft 365. Isto ajuda a garantir que o e-mail é entregue nas suas caixas de correio do Microsoft 365. Movendo o registro MX, você também poderá desativar seu sistema de email antigo quando estiver pronto.
Em muitos provedores DNS, existem instruções específicas para alterar o seu registro MX. Se o seu provedor DNS não for incluído, ou se você quiser ver diretrizes gerais, também são fornecidas instruções gerais de registro MX.
Pode levar até 72 horas para que os sistemas de email de seus clientes e parceiros reconheçam o registro MX alterado. Aguarde pelo menos 72 horas antes de prosseguir para a próxima tarefa: Etapa 6: Excluir o lote de migração IMAP.
Etapa 6: Excluir o lote de migração IMAP
Após alterar o registro MX e verificar que todos os emails estão sendo encaminhados para caixas de correio do Microsoft 365, notifique os usuários de que os emails serão enviados para o Microsoft 365. Depois disso, você pode excluir o lote de migração IMAP. Antes de excluir o lote de migração, verifique os itens a seguir.
Todos os utilizadores estão a utilizar caixas de correio do Microsoft 365. Depois de o lote ser eliminado, o correio enviado para as caixas de correio no local Exchange Server não é copiado para as caixas de correio do Microsoft 365 correspondentes.
As caixas de correio do Microsoft 365 foram sincronizadas pelo menos uma vez após o correio começar a ser enviado diretamente para as mesmas. Para tal, certifique-se de que o valor na caixa Hora da Última Sincronização do lote de migração é mais recente do que quando o correio começou a ser encaminhado diretamente para as caixas de correio do Microsoft 365.
Para excluir o lote de migração "IMAPBatch1" do PowerShell do Exchange Online, execute o seguinte comando:
Remove-MigrationBatch -Identity IMAPBatch1
Para saber mais sobre o cmdlet Remove-MigrationBatch, confiraRemove-MigrationBatch.
Verifique se funcionou
Execute o seguinte comando no PowerShell do Exchange Online para exibir informações sobre o "IMAPBatch1":
Get-MigrationBatch IMAPBatch1"
O comando retornará o lote de migração com um status de Removing ou retornará um erro afirmando que o lote de migração não foi encontrado, confirmando que o lote foi excluído.
Para saber mais sobre o cmdlet Get-MigrationBatch, confiraGet-MigrationBatch.