Arquivos CSV para lotes de migração IMAP em Exchange Online
O arquivo CSV (valores separados por vírgulas) que você usa para migrar o conteúdo das caixas de correio dos usuários em uma migração IMAP contém uma linha para cada usuário. Cada linha contém informações sobre a caixa de correio Office 365 do usuário e a caixa de correio IMAP e Office 365 usa essas informações para processar a migração.
Atributos requeridos
Veja a seguir os atributos necessários para cada usuário:
O EmailAddress especifica a ID de usuário da caixa de correio do Office 365 do usuário.
O UserName especifica o nome de logon do usuário da caixa de correio do usuário no servidor IMAP. Você pode usar o formato nome de usuário ou domínio\nome de usuário. Por exemplo:
hollyhoucontoso\hollyh.A Password é a senha da conta do usuário no sistema de mensagens IMAP.
A migração falha se algum desses atributos não estiver incluído na linha de cabeçalho do arquivo CSV. Além disso, digite os atributos exatamente como eles são exibidos. Os atributos não podem conter espaços. Eles devem ser uma única palavra. Por exemplo, Email Address é inválido. Você deve usar EmailAddress.
Formato de arquivo CSV
Aqui está um exemplo do formato do arquivo CSV. Neste exemplo, as credenciais do usuário são usadas para migrar três caixas de correio:
EmailAddress,UserName,Password
terrya@contoso.edu,contoso\terry.adams,1091990
annb@contoso.edu,contoso\ann.beebe,2111991
paulc@contoso.edu,contoso\paul.cannon,3281986
A primeira linha ou linha de cabeçalho do arquivo CSV lista os nomes de atributos, ou campos, especificados nas linhas seguintes. Cada nome de atributo é separado por uma vírgula.
Cada linha sob a linha de cabeçalho representa um usuário e fornece as informações que serão usadas para migrar a caixa de correio do usuário. Os valores do atributo em cada linha devem estar na mesma ordem que os nomes de atributo na linha de cabeçalho. Cada valor do atributo é separado por vírgula.
Use um editor de texto ou um aplicativo como o Microsoft Excel para criar o arquivo CSV. Salve o arquivo como um arquivo .csv ou .txt.
Dica
Se o arquivo CSV contiver caracteres especiais ou não ASCII, salve o arquivo CSV com UTF-8 ou outra codificação Unicode. Dependendo do aplicativo, salvar o arquivo CSV com UTF-8 ou outra codificação Unicode pode ser mais fácil quando o idioma usado no arquivo CSV coincidir com a localidade do sistema do computador.
Dividir uma migração grande em vários lotes
O arquivo CSV pode conter até 50.000 linhas, uma linha para cada usuário e pode ter 10 MB. Mas é uma boa ideia migrar os usuários em vários lotes menores.
Se você planeja migrar muitos usuários, decida quais serão incluídos em cada lote. Por exemplo, se você tiver 10.000 contas para migrar, seria possível executar quatro lotes com 2.500 usuários. Você também poderia dividir os lotes em ordem alfabética; por tipo de usuário, como professores, alunos e ex-alunos; por classe, como primeiro ano, segundo ano, terceiro ano e último ano; ou de outras maneiras para atender às necessidades da sua organização.
Dica
Uma estratégia é criar caixas de correio do Office 365 e migrar o email para o mesmo grupo de usuários. Por exemplo, se você importar 100 novos usuários para sua organização do Microsoft 365 ou Office 365, crie um lote de migração para esses mesmos 100 usuários. Essa é uma maneira eficaz de organizar e gerenciar a migração de um sistema de mensagens no local para o Office 365.
Fornecer credenciais de administrador ou usuário
No arquivo CSV, você precisa fornecer o nome de usuário e a senha para a conta local do usuário. Isso permite que o processo de migração acesse a conta. Há duas maneiras de fazer isso:
Usar credenciais de usuário: isso requer que você obtenha senhas dos usuários ou que altere suas senhas para um valor que você conhece para que você possa incluí-las no arquivo CSV.
Dica
Ao usar essa opção, você impede que os usuários alterem as senhas das contas no local. Se os usuários alterarem as senhas depois da migração inicial, as sincronizações subsequentes entre as caixas de correio no servidor IMAP e as caixas de correio do Office 365 falharão.
Use credenciais de super usuário ou administrador: isso exige que você use uma conta em seu sistema de mensagens IMAP que tenha os direitos necessários para acessar todas as caixas de correio do usuário. No arquivo CSV, você pode usar as credenciais dessa conta para cada linha. Para saber se o servidor IMAP dá suporte a essa abordagem e como habilitá-la, confira a documentação do servidor IMAP.
Observação
É uma boa ideia usar credenciais de administrador porque isso não afeta ou atrapalha os usuários. Por exemplo, não importa se os usuários alterarem suas senhas depois da migração inicial.
Formatar as credenciais de administrador de servidores IMAP diferentes
Você pode usar o nome de usuário e a senha de uma conta de administrador nos campos UserName e Password para cada linha do arquivo CSV. O nome de usuário para credenciais de administrador é uma combinação do nome de usuário para a pessoa cujo email está sendo migrado e o nome de usuário de uma conta de administrador que tem permissão para acessar todas as caixas de correio do usuário. O formato com suporte das credenciais do administrador é diferente, dependendo do servidor IMAP do qual você está migrando os emails. Para saber mais sobre como usar credenciais de administrador, confira a documentação do servidor IMAP.
Observação
Quando você envia uma nova solicitação de migração, o arquivo CSV é carregado para o datacenter da Microsoft através de uma conexão SSL (Secure Sockets Layer). As informações do arquivo CSV são criptografadas e armazenadas em servidores do Microsoft Exchange no datacenter da Microsoft.
As seções a seguir explicam como formatar as credenciais de administrador no arquivo CSV usado para migrar emails de diferentes tipos de 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. Você tem uma conta de administrador de email, em que o nome de usuário é mailadmin e a senha é P@ssw0rd. Veja aqui como seu arquivo CSV ficaria:
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 IMAP do Dovecot, use o formato User_UserName*Admin_UserName, em que o asterisco ( * ) é um caractere separador configurável. Digamos que você esteja migrando email desses mesmos usuários de um servidor IMAP Dovecot usando as credenciais de administrador mailadmin e P@ssw0rd. Veja aqui como seu arquivo CSV ficaria:
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 emails do Mirapoint usando as credenciais de administrador mailadmin e P@ssw0rd, seu arquivo CSV teria esta aparência:
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
Usar o atributo opcional UserRoot
Alguns servidores IMAP, como Courier IMAP, não dão suporte ao uso das credenciais de administrador para migrar caixas de correio para o Office 365. Para usar credenciais de administrador para migrar caixas de correio, você pode configurar seu servidor IMAP para usar pastas virtuais compartilhadas. Pastas virtuais compartilhadas permitem que os administradores usem credenciais de logon do administrador para acessar caixas de correio do usuário no servidor IMAP. Para saber mais sobre como configurar as pastas virtuais compartilhadas do Courier IMAP, confira Pastas Compartilhadas.
Para migrar caixas de correio após configurar pastas compartilhadas virtuais no servidor IMAP, você precisa incluir o atributo opcional UserRoot no arquivo CSV. Esse atributo especifica a localização da caixa de correio de cada usuário na estrutura de pasta virtual compartilhada do servidor IMAP.
Este é 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