Arquivos CSV para migração de caixa de correio

Aplica-se a: Exchange Server 2013

Você pode usar um arquivo CSV para migrar em massa um grande número de caixas de correio de usuário. Você pode especificar um arquivo CSV ao usar o EAC (Centro de administração do Exchange) ou o cmdlet New-MigrationBatch do Shell de Gerenciamento do Exchange para criar um lote de migração. O uso de um CSV para especificar vários usuários para migrar em um lote de migração é compatível com os seguintes cenários de migração:

  • Movimentação em organizações do Exchange no local

    • Movimentação local: Um movimento local é onde você move caixas de correio de um banco de dados de caixa de correio para outro. Uma movimentação local ocorre dentro de uma só floresta.

    • Movimento empresarial entre florestas: Em um movimento empresarial entre florestas, as caixas de correio são movidas para uma floresta diferente. Movimentações entre florestas são iniciadas da floresta de destino, que é a floresta para a qual você deseja mover as caixas de correio, ou da floresta de origem, que é a floresta que atualmente hospeda caixas de correio.

    • Inclusão e exclusão no Exchange Online

    • Integrando a migração de movimento remoto: Em uma implantação híbrida do Exchange, você pode mover caixas de correio de uma organização local do Exchange para Exchange Online. Isso também é conhecido como uma migração de movimento remoto integrado porque você integra as caixas de correio para Exchange Online.

    • Integrando a migração de movimento remoto: Você também pode executar uma migração de movimento remoto offboarding, na qual migra Exchange Online caixas de correio para sua organização local do Exchange.

    Observação

    As migrações de movimento remoto de integração e de integração são iniciadas de sua organização Exchange Online.

    • Migração do Exchange em etapas: Você também pode migrar um subconjunto de caixas de correio de uma organização local do Exchange para Exchange Online. Este é outro tipo de migração de integração. Você pode migrar somente as caixas de correio do Exchange 2003 e do Exchange 2007 usando uma migração do Exchange em estágios. Não há suporte para a migração em estágios das caixas de correio do Exchange 2010 e do Exchange 2013. Antes de executar uma migração em etapas, você precisa usar a sincronização de diretório ou algum outro método para provisionar usuários de email em sua organização Exchange Online.

    • Migração IMAP: Esse tipo de migração de integração migra dados de caixa de correio de um servidor IMAP (incluindo o Exchange) para Exchange Online. Para uma migração IMAP, você deve provisionar caixas de correio em Exchange Online antes de migrar dados da caixa de correio.

Observação

Uma migração de corte do Exchange não dá suporte a um usando um arquivo CSV porque todas as caixas de correio de usuário locais são migradas para Exchange Online em um único lote.

Atributos com suporte a arquivos CSV para movimentações ou migrações em massa

A primeira linha ou a linha de cabeçalho de um arquivo CSV usado para migrar as listas de usuários dos nomes dos 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 individual e fornece as informações necessárias para a migração. Os atributos em cada linha individual do usuário devem estar na mesma ordem que os nomes de atributo na linha de cabeçalho. Cada valor do atributo é separado por uma vírgula. Se o valor do atributo de um determinado registro for nulo, não digite nada para esse atributo. No entanto, inclua a vírgula para separar o valor nulo do atributo seguinte.

Os valores de atributo no arquivo CSV substituem o valor do parâmetro correspondente quando esse mesmo parâmetro é usado ao criar um lote de migração com o EAC ou o Shell de Gerenciamento do Exchange. Para saber mais e ver exemplos, confira a seção Os valores de atributo no arquivo CSV substituem os valores do lote de migração.

Dica

Você pode usar um editor de texto para criar o arquivo CSV, mas usar um aplicativo como o Microsoft Excel facilita a importação dos dados, a configuração e a organização de arquivos CSV. Salve os arquivos CSV como um arquivo .csv ou .txt.

As seções a seguir descrevem os atributos com suporte à linha de cabeçalho de um arquivo CSV para cada tipo de migração. Cada seção inclui uma tabela que lista cada atributo com suporte, a obrigatoriedade ou não dele, um exemplo de um valor a ser usado para o atributo e uma descrição.

Observação

  • Nas seções a seguir, o ambiente de origem denota o local atual de uma caixa de correio do usuário ou de um banco de dados. O ambiente de destino denota o local para o qual a caixa de correio será migrada ou o banco de dados para o qual a caixa de correio será movida.
  • Todas as caixas de correio especificadas no arquivo CSV serão migradas, mesmo que estejam fora do escopo RBAC (por exemplo, uma OU) que fornece permissões de administrador para migrar caixas de correio.

Movimentos locais

A tabela a seguir descreve os atributos com suporte para um arquivo CSV para movimentos locais. Para saber mais, confira Gerenciar movimentações de local.

Atributo Obrigatório ou opcional Valores aceitos Descrição
EmailAddress Obrigatório Endereço SMTP do usuário Especifica o usuário que será movido.
Targetdatabase Opcional GUID do banco de dados Especifica o banco de dados da caixa de correio para o qual a caixa de correio primária do usuário será movida. Você pode especificar um banco de dados diferente nas diferentes linhas do arquivo CSV, que permite mover caixas de correio no mesmo lote de migração para bancos de dados diferentes.
TargetArchiveDatabase Opcional GUID do banco de dados Especifica o banco de dados da caixa de correio para o qual a caixa de correio de arquivo do usuário será movida. Você pode especificar um banco de dados diferente nas diferentes linhas do arquivo CSV, o que permite mover caixas de correio de arquivo no mesmo lote de migração para bancos de dados diferentes.

Observação: se você especificar um banco de dados de arquivo específico, a caixa de correio de arquivo (se ela existir) será movida para o mesmo banco de dados que a caixa de correio primária.
Baditemlimit Opcional Unlimited ou um inteiro não negativo de 0 (o padrão) para um valor máximo de 2147483647 Especifica o número de itens ruins a serem ignorados se o serviço de migração encontrar um item corrompido na caixa de correio. Se você incluir esse atributo no arquivo CSV, ele substituirá o valor padrão ou um valor que você especificar se incluir o parâmetro BadItemLimit ao criar o lote de migração usando o EAC ou o Shell de Gerenciamento do Exchange.

Dica: recomendamos que você use o valor padrão de 0 e só aumente o limite de item ruim para um determinado usuário se a movimentação ou migração para esse usuário falhar.
MailboxType Opcional Use um dos valores a seguir:
  • PrimaryOnly
  • ArchiveOnly
  • PrimaryAndArchive (o valor padrão)
Especifica se o usuário deve mover a caixa de correio primária do usuário, a caixa de correio de arquivo ou ambos.

Integrando migrações de movimento remoto em uma implantação híbrida

Em uma implantação híbrida, você pode mover caixas de correio de uma organização local do Exchange para Exchange Online. Ao integrar caixas de correio, o lote de migração é criado na organização Exchange Online e iniciado por um administrador Exchange Online. Para obter mais informações, consulte Mover caixas de correio entre organizações locais e Exchange Online em implantações híbridas.

A tabela a seguir descreve os atributos com suporte para um arquivo CSV para integrar migrações de movimento remoto.

Atributo Obrigatório ou opcional Valores aceitos Descrição
EmailAddress Obrigatório Endereço SMTP do usuário Especifica o endereço de email do usuário habilitado para email na organização Exchange Online que corresponde à caixa de correio do usuário local que será migrada.
Baditemlimit Opcional Unlimited ou um inteiro não negativo de 0 (o padrão) para um valor máximo de 2147483647 Especifica o número de itens ruins a serem ignorados se o serviço de migração encontrar um item corrompido na caixa de correio. Se você incluir esse atributo no arquivo CSV, ele substituirá o valor padrão ou o valor especificado se você incluir o parâmetro BadItemLimit ao criar o lote de migração usando o EAC ou o Shell de Gerenciamento do Exchange.

Dica: recomendamos que você use o valor padrão de 0 e só aumente o limite de item ruim para um determinado usuário se a movimentação ou migração para esse usuário falhar.
LargeItemLimit Opcional Unlimited ou um inteiro não negativo de 0 (o padrão) para um valor máximo. Especifica o número de itens grandes na caixa de correio do usuário que serão ignorados. Quando o número de itens grandes excede esse valor, a migração para a caixa de correio falha.

O valor padrão é 0, o que significa que a migração falhará se a caixa de correio contiver itens grandes.

Ao integrar caixas de correio para Exchange Online, itens de até 35 MB são migrados.
MailboxType Opcional Use um dos valores a seguir:
  • PrimaryOnly
  • ArchiveOnly
  • PrimaryAndArchive (o valor padrão)
Especifica se o usuário deve mover a caixa de correio primária do usuário, a caixa de correio de arquivo ou ambos.

A empresa entre florestas move e offboarding de migrações de movimento remoto em uma implantação híbrida

Conforme indicado anteriormente, os movimentos entre florestas são iniciados a partir da floresta de destino ou da floresta de origem. As migrações de movimentação remota de offboard são iniciadas de sua organização Exchange Online. Para saber mais, veja:

A tabela a seguir descreve os atributos com suporte para um arquivo CSV para movimentos corporativos entre florestas e para a integração de migrações de movimento remoto em uma implantação híbrida do Exchange.

Atributo Obrigatório ou opcional Valores aceitos Descrição
EmailAddress Obrigatório Endereço SMTP do usuário Para movimentos empresariais entre florestas, isso especifica a caixa de correio ou o usuário habilitado para email na floresta de origem.

Para o offboard de migrações de movimento remoto, ele especifica a caixa de correio Exchange Online.
Targetdatabase Necessário para o offboard de migrações de movimento remoto e para movimentos empresariais entre florestas que são iniciados a partir da floresta de origem. Como alternativa, esse atributo pode ser especificado ao criar o lote de migração no EAC ou usar o Shell de Gerenciamento do Exchange.

Esse atributo é opcional para movimentos empresariais entre florestas que são iniciados a partir da floresta de destino.
GUID do banco de dados Especifica o banco de dados da caixa de correio na floresta de destino para a qual a caixa de correio primária do usuário será movida. Você pode especificar um banco de dados diferente nas diferentes linhas do arquivo CSV, que permite mover caixas de correio no mesmo lote de migração para bancos de dados diferentes.
TargetArchiveDatabase Opcional GUID do banco de dados Especifica o banco de dados da caixa de correio na floresta de destino para a qual a caixa de correio de arquivo do usuário será movida. Você pode especificar um banco de dados diferente nas diferentes linhas do arquivo CSV, o que permite mover caixas de correio de arquivo no mesmo lote de migração para bancos de dados diferentes.
Baditemlimit Opcional Unlimited ou um inteiro não negativo de 0 (o padrão) para um valor máximo de 2147483647 Especifica o número de itens ruins a serem ignorados se o serviço de migração encontrar um item corrompido na caixa de correio. Se você incluir esse atributo no arquivo CSV, ele substituirá o valor padrão ou o valor especificado se você incluir o parâmetro BadItemLimit ao criar o lote de migração usando o EAC ou o Shell de Gerenciamento do Exchange.

Dica: recomendamos que você use o valor padrão de 0 e só aumente o limite de item ruim para um determinado usuário se a movimentação ou migração para esse usuário falhar.
LargeItemLimit Opcional Unlimited ou um inteiro não negativo de 0 (o padrão) para um valor máximo. Especifica o número de itens grandes na caixa de correio do usuário que serão ignorados. Quando o número de itens grandes excede esse valor, a migração para a caixa de correio falha.

O valor padrão é 0, o que significa que a migração falhará se a caixa de correio contiver itens grandes.

Ao integrar caixas de correio para Exchange Online, itens de até 35 MB são migrados.
MailboxType Opcional Use um dos valores a seguir:
  • PrimaryOnly
  • ArchiveOnly
  • PrimaryAndArchive (o valor padrão)
Especifica se o usuário deve mover a caixa de correio primária do usuário, a caixa de correio de arquivo ou ambos.

Migração em estágios do Exchange

Você precisa usar um arquivo CSV para identificar o grupo de usuários de um lote de migração quando quiser usar uma migração do Exchange em etapas para migrar as caixas de correio locais do Exchange 2003 e exchange 2007 para Exchange Online. Não há um limite para o número de caixas de correio que você pode migrar para a nuvem usando uma migração em estágios do Exchange. No entanto, o arquivo CSV de um lote de migração pode conter um máximo de 1.000 linhas. Para migrar mais de 1.000 caixas de correio, você precisa criar arquivos CSV adicionais e, em seguida, usar cada um para criar um novo lote de migração. Para obter mais informações sobre migrações em etapas do Exchange, consulte Migrar caixas de correio para Exchange Online com uma migração em etapas.

A tabela a seguir descreve os atributos com suporte a um arquivo CSV para uma migração em estágios do Exchange.

Atributo Obrigatório ou opcional Valores aceitos Descrição
EmailAddress Obrigatório Endereço SMTP do usuário Especifica o endereço de email do usuário habilitado para email (ou uma caixa de correio se você estiver repetindo a migração) em Exchange Online que corresponde à caixa de correio do usuário local que será migrada. Os usuários habilitados para email são criados em Exchange Online como resultado da sincronização do diretório ou de outro processo de provisionamento. O endereço de email do usuário habilitado para email deve corresponder à propriedade WindowsEmailAddress para a caixa de correio local correspondente.
Password Opcional Uma senha precisa ter um comprimento mínimo de oito caracteres e atender a quaisquer restrições de senha aplicadas à sua organização do Microsoft 365 ou Office 365. Essa senha é definida na conta de usuário quando o usuário habilitado para email correspondente no Exchange Online é convertido em uma caixa de correio durante a migração.
ForceChangePassword Opcional True ou False Especifica se um usuário deve alterar a senha na primeira vez que entrar em sua caixa de correio Exchange Online.

Observação: se você implementou uma única solução de logon implantando Serviços de Federação do Active Directory (AD FS) 2.0 (AD FS 2.0) em sua organização local, você deve usar False para o valor desse atributo.

Migrações IMAP

Um arquivo CSV de um lote de migração IMAP pode ter o máximo de 50.000 linhas. Mas é uma boa ideia migrar os usuários em vários lotes menores. Para saber mais sobre a migração IMAP, confira os tópicos a seguir:

A tabela a seguir descreve os atributos com suporte a um arquivo CSV para uma migração IMAP.

Atributo Obrigatório ou opcional Valores aceitos Descrição
EmailAddress Obrigatório Endereço SMTP do usuário. Especifica a ID do usuário para a caixa de correio Exchange Online do usuário
UserName Obrigatório Cadeia de caracteres que identifica o usuário no sistema de mensagens IMAP em um formato com suporte no servidor IMAP. Especifica o nome de logon da conta do usuário no sistema de mensagens IMAP (ambiente de origem). 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. Para saber mais, confira o artigo Arquivos CSV de lotes de migração IMAP.
Senha Obrigatório Cadeia de caracteres de senha. Especifica a senha da conta de usuário especificada pelo atributo UserName.

Os valores de atributo no arquivo CSV substituem os valores do lote de migração

Os valores de atributo no arquivo CSV substituem o valor do parâmetro correspondente quando esse mesmo parâmetro é usado ao criar um lote de migração com o EAC ou o Shell de Gerenciamento do Exchange. Se quiser que o valor de lote de migração seja aplicado a um usuário, você pode deixar essa célula em branco no arquivo CSV. Isso permite misturar e combinar valores específicos do atributo dos usuários selecionados em um lote de migração.

Por exemplo, digamos que você crie um lote no Shell de Gerenciamento do Exchange para um movimento empresarial entre florestas para mover as caixas de correio primárias e de arquivo dos usuários para a floresta de destino com o seguinte comando do Shell de Gerenciamento do Exchange.

New-MigrationBatch -Name CrossForestBatch1 -SourceEndpoint ForestEndpoint1 -TargetDeliveryDomain forest2.contoso.com -TargetDatabases @(EXCH-MBX-02,EXCH-MBX-03) -TargetArchiveDatabases @(EXCH-MBX-A02,EXCH-MBX-A03) -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\CrossForestBatch1.csv")) -AutoStart

Observação

Como o padrão é mover caixas de correio primárias e de arquivo, você não precisa especiá-la explicitamente no comando Shell de Gerenciamento do Exchange.

Uma parte do arquivo CrossForestBatch1.csv para este lote de migração tem a seguinte aparência:

EmailAddress,TargetDatabase,TargetArchiveDatabase
user1@contoso.com,EXCH-MBX-01,EXCH-MBX-A01
user2@contoso.com,,
user3@contoso.com,EXCH-MBX-01,
...

Como os valores no arquivo CSV substituem os valores do lote de migração, as caixas de correio primárias e de arquivo do user1 são movidas para EXCH-MBX-01 e EXCH-MBX-A01, respectivamente, na floresta de destino. As caixas de correio primárias e de arquivo para user2 são movidas para EXCH-MBX-02 ou EXCH-MBX-03. A caixa de correio primária para user3 é movida para EXCH-MBX-01 e a caixa de correio de arquivo é movida para EXCH-MBX-A02 ou EXCH-MBX-A03.

Em outro exemplo, digamos que você crie um lote para uma migração remota de integração em uma implantação híbrida para mover caixas de correio de arquivo para Exchange Online com o comando a seguir.

New-MigrationBatch -Name OnBoarding1 -SourceEndpoint RemoteEndpoint1 -TargetDeliveryDomain cloud.contoso.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\OnBoarding1.csv")) -MailboxType ArchiveOnly -AutoStart

Mas você também deseja mover as caixas de correio principais dos usuários selecionados, para que uma parte do arquivo OnBoarding1.csv deste lote de migração tenha esta aparência:

EmailAddress,MailboxType
user1@contoso.com,
user2@contoso.com,
user3@cloud.contoso.com,PrimaryAndArchive
user4@cloud.contoso.com,PrimaryAndArchive
...

Como o valor do tipo de caixa de correio no arquivo CSV substitui os valores do parâmetro MailboxType no comando para criar o lote, apenas a caixa de correio de arquivo para user1 e user2 é migrada para Exchange Online. Mas as caixas de correio primárias e de arquivo para usuário3 e user4 são movidas para Exchange Online.