Utilizar o PowerShell para efetuar uma migração IMAP para o Microsoft 365
Este artigo aplica-se tanto a Microsoft 365 Enterprise como a 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 explica-lhe as tarefas de uma migração IMAP de e-mail com o Exchange Online PowerShell.
Nota
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.
O que precisa de saber antes de começar?
Tempo estimado para concluir esta tarefa: 2 a 5 minutos para criar um lote de migração. Após o início do lote de migração, 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 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.
Precisam de lhe ser atribuídas permissões antes de poder efetuar este procedimento ou procedimentos. 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, veja Cmdlets de migração e movimentação.
As seguintes restrições aplicam-se às migrações IMAP:
Apenas os itens na caixa de entrada de um utilizador ou noutras pastas de correio podem ser migrados. Não pode migrar contactos, itens de calendário ou tarefas.
Pode ser migrado um máximo de 500 000 itens a partir da caixa de correio de um utilizador.
O tamanho máximo da mensagem que pode ser migrado é de 35 MB.
Passos de migração
Passo 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.
Obtenha 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 an IMAP client or the PING command to verify that you can use the FQDN to communicate with the IMAP server over the Internet.
Configure a firewall para permitir ligações IMAP. Poderá ter de abrir portas na firewall da organização que aloja o servidor IMAP para que o tráfego de rede proveniente do datacenter da Microsoft durante a migração possa entrar na organização que aloja 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.
Atribua permissões de conta de administrador para aceder a caixas de correio na sua organização IMAP. If you use administrator credentials in the CSV file, the account that you use must have the necessary permissions to access the on-premises mailboxes. As permissões necessárias para aceder às caixas de correio dos utilizadores 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, veja Cmdlets de migração e movimentação.
Verifique se consegue ligar ao servidor IMAP. Execute o seguinte comando no Exchange Online PowerShell para testar as definições de ligaçã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 Porta , é típico utilizar 143 para ligações não encriptadas ou TLS (Transport Layer Security) e utilizar 993 para ligações SSL.
Passo 2: Criar um ficheiro CSV para um lote de migração IMAP
Identifique o grupo de utilizadores cujas caixas de correio pretende migrar num lote de migração IMAP. Cada linha no ficheiro CSV contém informações necessárias para ligar a uma caixa de correio no sistema de mensagens IMAP.
Eis os atributos necessários para cada utilizador:
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.
A palavra-passe especifica a palavra-passe da conta na coluna Nome de Utilizador .
Segue-se um exemplo do formato do ficheiro CSV. Neste exemplo, são migradas três caixas de correio:
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 , para além do nome de utilizador, pode utilizar as credenciais de uma conta a quem foram atribuídas as permissões necessárias para aceder a caixas de correio no servidor IMAP. Seguem-se alguns dos formatos específicos utilizados para alguns dos servidores IMAP:
Microsoft Exchange:
Se estiver a migrar e-mail da implementação IMAP para o Microsoft Exchange, utilize o formato Domain/Admin_UserName/User_UserName no atributo UserName no ficheiro CSV. Imaginemos que está a migrar e-mail a partir do Exchange para os utilizadores Terry Adams, Ann Beebe, e Paul Cannon. Tem uma conta de administrador de correio, em que o nome de utilizador é mailadmin e a palavra-passe é P@ssw0rd. O seu ficheiro CSV teria o seguinte aspeto:
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 suportam SaSL (Simple Authentication and Security Layer), como um servidor IMAP Dovecot, utilize o formato User_UserName*Admin_UserName, em que o asterisco ( * ) é um caráter 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. O seu ficheiro CSV teria o seguinte aspeto:
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 estiver a migrar e-mail do Mirapoint Message Server, utilize 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 alternativa, pode configurar o seu sistema de e-mail de origem para utilizar pastas partilhadas virtuais. Ao utilizar pastas partilhadas virtuais, pode utilizar as credenciais de administrador da caixa de correio para aceder às caixas de correio dos utilizadores no sistema de e-mail de origem. Para obter mais informações sobre como configurar pastas partilhadas virtuais no Courier IMAP, consulte o artigo Pastas Partilhadas.
Para migrar caixas de correio após configurar as pastas partilhadas virtuais no sistema de e-mail de origem, terá de incluir o atributo opcional UserRoot no ficheiro de migração. Este atributo especifica a localização de cada caixa de correio de utilizador na estrutura da pasta partilhada virtual no sistema de e-mail de origem. Por exemplo, o caminho para a caixa de correio do Terry é /users/terry.adams.
Eis um exemplo de um ficheiro 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
Passo 3: Criar um ponto final 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 final de migração também define o número de caixas de correio a migrar em simultâneo e o número de caixas de correio a sincronizar em simultâneo 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, veja Cmdlets de migração e movimentação.
Para criar o ponto final de migração IMAP denominado "IMAPEndpoint" no Exchange Online PowerShell, execute o seguinte comando:
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 993 -Security Ssl
Também pode adicionar parâmetros para especificar migrações simultâneas, migrações incrementais simultâneas e a porta a utilizar. O seguinte Exchange Online comando do PowerShell cria um ponto final de migração IMAP chamado "IMAPEndpoint" que suporta 50 migrações simultâneas e até 25 sincronizações incrementais simultâneas. Também configura o ponto final para utilizar a porta 143 para encriptação TLS.
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations
50 -MaxConcurrentIncrementalSyncs 25
Para obter mais informações sobre o cmdlet New-MigrationEndpoint , vejaNew-MigrationEndpoint.
Verificar se funcionou
Execute o seguinte comando no Exchange Online PowerShell para apresentar informações sobre o "IMAPEndpoint":
Get-MigrationEndpoint IMAPEndpoint | Format-List EndpointType,RemoteServer,Port,Security,Max*
Passo 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 Exchange Online comando do PowerShell iniciará automaticamente o lote de migração denominado "IMAPBatch1" com o ponto final IMAP denominado "IMAPEndpoint":
New-MigrationBatch -Name IMAPBatch1 -SourceEndpoint IMAPEndpoint -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -AutoStart
Verificar se funcionou
Execute o cmdlet Get-MigrationBatch para apresentar informações sobre o "IMAPBatch1":
Get-MigrationBatch -Identity IMAPBatch1 | Format-List
Também pode verificar se o lote foi iniciado ao executar o seguinte comando:
Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status
Passo 5: Encaminhar o seu e-mail para o Microsoft 365
Os sistemas de e-mail utilizam um registo DNS denominado registo MX para detetar onde os e-mails devem ser entregues. Durante o processo de migração de e-mail, o seu registo MX estava a apontar para o seu sistema de e-mail 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. Ao mover o registo MX, também pode desativar o seu sistema de e-mail antigo quando estiver pronto.
Para vários fornecedores de DNS, existem instruções específicas sobre como alterar o seu registo MX. Se o seu fornecedor de DNS não estiver incluído ou se pretender ter uma ideia das instruções gerais, também são fornecidas instruções gerais sobre o registo MX.
Os sistemas de e-mail dos seus clientes e parceiros podem demorar até 72 horas para reconhecer o registo MX alterado. Aguarde pelo menos 72 horas antes de avançar para a tarefa seguinte: Passo 6: Eliminar o lote de migração IMAP.
Passo 6: Eliminar o lote de migração IMAP
Depois de alterar o registo MX e verificar se todos os e-mails estão a ser encaminhados para as caixas de correio do Microsoft 365, notifique os utilizadores de que o respetivo e-mail vai para o Microsoft 365. Depois disso, pode eliminar o lote de migração IMAP. Verifique o seguinte antes de eliminar o lote de migração.
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 eliminar o lote de migração "IMAPBatch1" do Exchange Online PowerShell, execute o seguinte comando:
Remove-MigrationBatch -Identity IMAPBatch1
Para obter mais informações sobre o cmdlet Remove-MigrationBatch , vejaRemove-MigrationBatch.
Verificar se funcionou
Execute o seguinte comando no Exchange Online PowerShell para apresentar informações sobre o "IMAPBatch1":
Get-MigrationBatch IMAPBatch1"
O comando irá devolver o lote de migração com o estado Remover ou irá devolver um erro a indicar que não foi possível encontrar o lote de migração, verificando se o lote foi eliminado.
Para obter mais informações sobre o cmdlet Get-MigrationBatch , vejaGet-MigrationBatch.