Usar o PowerShell para executar uma migração em etapas para o Microsoft 365

  • Artigo

Esse artigo se aplica ao Microsoft 365 Enterprise e ao Office 365 Enterprise.

Você pode migrar o conteúdo das caixas de correio de usuário de um sistema de email de origem para o Microsoft 365 ao longo do tempo usando uma migração em etapas.

Este artigo o orienta ao longo das tarefas envolvidas para uma migração em estágios de email usando o PowerShell do Exchange Online. O tópico, o que você precisa saber sobre uma migração de email em etapas, fornece uma visão geral do processo de migração. Quando você estiver familiarizado com os conteúdos do artigo, use o seguinte para começar a migrar caixas de correio de um sistema de email para outro.

Observação

Você também pode usar o centro de administração do Exchange para executar a migração em etapas. Consulte Executar uma migração de email em etapas para o Microsoft 365.

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 quanto tempo leva para migrar caixas de correio para o Microsoft 365, consulte Desempenho de Migração.

Para executar este procedimento ou estes procedimentos, você precisa receber permissões. Para ver quais permissões você precisa, consulte a entrada "Migração" no tópico Permissões de Destinatários .

Para usar os cmdlets Exchange Online PowerShell, você precisa entrar e importar os cmdlets para a sessão de Windows PowerShell local. Consulte Conectar 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.

Etapas da migração

Etapa 1: preparar para uma migração em estágios

Antes de migrar as caixas de correio para o Microsoft 365 usando uma migração em etapas, há algumas alterações que você deve fazer no ambiente do Exchange.

Configurar o Outlook em Qualquer Lugar no seu Exchange Server local O serviço de migração de email usa Outlook em Qualquer Lugar (também conhecido como RPC sobre HTTP) para se conectar ao seu Exchange Server local. Para obter informações sobre como configurar o Outlook Anywhere para Exchange Server 2007 e o Exchange 2003, confira o seguinte:

Importante

Você deve usar um certificado emitido por uma AC (autoridade de certificação) confiável com a sua configuração do Outlook em Qualquer Lugar. O Outlook em Qualquer Lugar não pode ser configurado com um certificado auto-assinado. Para saber mais, consulte Como configurar o SSL para o Outlook em Qualquer Lugar.

Opcional: Verifique se você pode se conectar à sua organização do Exchange usando o Outlook em Qualquer Lugar Tente um dos métodos a seguir para testar as configurações de conexão.

  • Use o Outlook fora de sua rede corporativa para se conectar a sua caixa de correio local do Exchange.

  • Use o Analisador de Conectividade Remota da Microsoft para testar suas configurações de conexão. Use o Outlook em Qualquer Lugar (RPC sobre HTTP) ou os testes de Descoberta Automática do Outlook.

  • Execute os seguintes comandos no PowerShell do Exchange Online:

    $Credentials = Get-Credential

    Test-MigrationServerAvailability -ExchangeOutlookAnywhere -Autodiscover -EmailAddress <email address for on-premises administrator> -Credentials $credentials

Definir permissões A conta de usuário local que você usa para se conectar à sua organização local do Exchange (também chamada de administrador de migração) deve ter as permissões necessárias para acessar as caixas de correio locais que você deseja migrar para o Microsoft 365. Essa conta de usuário é usada quando você se conecta ao seu sistema de email criando um ponto de extremidade de migração mais tarde neste procedimento Etapa 3: Criar um ponto de extremidade de migração.

Para migrar as caixas de correio, o administrador deve ter um dos seguintes conjuntos de permissão:

  • Ser membro do grupo Administradores de Domínio no Active Directory na organização local.

    ou

  • Ter a permissão FullAccess para cada caixa de correio local e a permissão WriteProperty para modificar a propriedade TargetAddress nas contas de usuário locais.

    ou

  • Ter a permissão Receive As no banco de dados de caixa de correio local que armazena as caixas de correio do usuário e a permissão WriteProperty para modificar a propriedade TargetAddress nas contas de usuário locais.

Para obter instruções sobre como definir essas permissões, consulte Atribuir permissões para migrar caixas de correio para o Microsoft 365.

Desabilitar UM (Unificação de Mensagens) Se a UM estiver ativada para as caixas de correio locais que você está migrando, desative a UM antes da migração. Ative a Unificação de Mensagens para as caixas de correio após a migração estar concluída. Para obter etapas de instruções, confiradesabilitar mensagens unificadas.

Use a sincronização de diretório para criar novos usuários no Microsoft 365. Você usa a sincronização de diretório para criar todos os usuários locais em sua organização do Microsoft 365.

Você precisa licenciar os usuários depois que eles são criados. O prazo é de 30 dias para adicionar licenças depois que os usuários são criados. Para obter as etapas para adicionar licenças, confira Step 8: Complete post-migration tasks.

Você pode usar a Ferramenta de Sincronização Microsoft Entra ou o Microsoft Azure AD Sync Services para sincronizar e criar seus usuários locais no Microsoft 365. Depois que as caixas de correio são migradas para o Microsoft 365, você gerencia contas de usuário em sua organização local e elas são sincronizadas com sua organização Microsoft 365. Para obter mais informações, confiraIntegração do Diretório .

Etapa 2: criar um arquivo CSV para um lote de migração em estágios

Depois de identificar os usuários cujas caixas de correio locais você deseja migrar para o Microsoft 365, use um arquivo CSV (valor separado por vírgulas) para criar um lote de migração. Cada linha no arquivo CSV, usada pelo Microsoft 365 para executar a migração, contém informações sobre uma caixa de correio local.

Observação

Não há um limite para o número de caixas de correio que você pode migrar para o Microsoft 365 usando uma migração em etapas. O arquivo CSV para um lote de migração pode conter um máximo de 2.000 linhas. Para migrar mais de 2.000 caixas de correio, crie arquivos CSV adicionais e use cada arquivo para criar um novo lote de migração.

Atributos com suporte

O arquivo CSV para uma migração em etapas oferece suporte aos três seguintes atributos. Cada linha no arquivo CSV corresponde a uma caixa de correio e deve conter um valor para cada um desses atributos.

Atributo Descrição Obrigatório?
EmailAddress
 Especifica o endereço de email SMTP primário, por exemplo, pilarp@contoso.com, para caixas de correio locais.
Use o endereço SMTP primário para caixas de correio locais e não IDs de usuário do Microsoft 365. Por exemplo, se o domínio local for nomeado contoso.com mas o domínio de email do Microsoft 365 for nomeado service.contoso.com, você usará o nome de domínio contoso.com para endereços de email no arquivo CSV.
Obrigatório
Senha
 A senha a ser definida para a nova caixa de correio do Microsoft 365. Todas as restrições de senha aplicadas à sua organização do Microsoft 365 também se aplicam às senhas incluídas no arquivo CSV.
Opcional
ForceChangePassword
 Especifica se um usuário deve alterar a senha na primeira vez que entrar na nova caixa de correio do Microsoft 365. Use True ou False para o valor deste parâmetro.
>[! OBSERVAÇÃO]> Se você implementou uma solução SSO (logon único) implantando Serviços de Federação do Active Directory (AD FS) (AD FS) ou superior em sua organização local, você deve usar False para o valor do atributo ForceChangePassword.		 Opcional

Formato de arquivo CSV

Veja a seguir um exemplo do formato do arquivo CSV. Neste exemplo, três caixas de correio locais são migradas para o Microsoft 365.

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.

EmailAddress,Password,ForceChangePassword
pilarp@contoso.com,Pa$$w0rd,False
tobyn@contoso.com,Pa$$w0rd,False
briant@contoso.com,Pa$$w0rd,False

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 de atributo em cada linha devem estar na mesma ordem que os nomes dos atributos na linha de cabeçalho.

Use qualquer editor de texto ou um aplicativo como o Excel para criar o arquivo CSV. Salve-o como um arquivo .csv ou .txt.

Observação

Se o arquivo CSV contiver caracteres não-ASCII ou especiais, salve-o 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 a localidade do sistema do computador corresponde ao idioma usado no arquivo CSV.

Etapa 3: criar um ponto de extremidade de migração

Para migrar o email com êxito, o Microsoft 365 precisa se conectar e se comunicar com o sistema de email de origem. Para fazer isso, o Microsoft 365 usa um ponto de extremidade de migração. Para criar um ponto de extremidade de migração do Outlook Anywhere usando o PowerShell, para migração em etapas, primeiro conecte-se ao Exchange Online.

Para obter uma lista completa dos comandos de migração, confira Cmdlets de movimentação e migração.

Para criar um ponto de extremidade de migração do Outlook em Qualquer Lugar chamado "StagedEndpoint" no PowerShell do Exchange Online, execute os seguintes comandos:

$Credentials = Get-Credential

New-MigrationEndpoint -ExchangeOutlookAnywhere -Name StagedEndpoint -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

Para saber mais sobre o cmdlet New-MigrationEndpoint, confiraNew-MigrationEndpoint.

Observação

O cmdlet New-MigrationEndpoint pode ser usado para especificar um banco de dados para o serviço a ser usado usando a opção -TargetDatabase . Caso contrário, um banco de dados é atribuído aleatoriamente do site Serviços de Federação do Active Directory (AD FS) (AD FS) 2.0 em que a caixa de correio de gerenciamento está localizada.

Verifique se funcionou

No PowerShell do Exchange Online, execute o seguinte comando para exibir informações sobre o ponto de extremidade de migração "StagedEndpoint":

Get-MigrationEndpoint StagedEndpoint | Format-List EndpointType,ExchangeServer,UseAutoDiscover,Max*

Etapa 4: criar e iniciar um lote de migração em estágios

Você pode usar o cmdlet New-MigrationBatch no PowerShell do Exchange Online para criar um lote de migração de uso em uma migração de transferência. Você pode criar um lote de migração e iniciá-lo automaticamente, incluindo o parâmetro AutoStart . Como alternativa, você pode criar o lote de migração e iniciá-lo manualmente mais tarde usando o cmdlet Start-MigrationBatch. Este exemplo cria um lote de migração chamado "StagedBatch1" e utiliza o ponto de extremidade de migração criado na etapa anterior.

New-MigrationBatch -Name StagedBatch1 -SourceEndpoint StagedEndpoint -AutoStart

Este exemplo também cria um lote de migração chamado "StagedBatch1" e utiliza o ponto de extremidade de migração criado na etapa anterior. Como o parâmetro AutoStart não está incluído, o lote de migração deve ser iniciado manualmente no painel de migração ou usando o cmdlet Start-MigrationBatch. Como dito anteriormente, apenas um lote de migração de transferência pode existir de cada vez.

New-MigrationBatch -Name StagedBatch1 -SourceEndpoint StagedEndpoint

Verifique se funcionou

Execute o seguinte comando no PowerShell do Exchange Online para exibir informações sobre o "StagedBatch1":

Get-MigrationBatch -Identity StagedBatch1 | Format-List

Você também pode verificar se o lote foi iniciado executando o seguinte comando:

Get-MigrationBatch -Identity StagedBatch1 | Format-List Status

Para saber mais sobre o cmdlet Get-MigrationBatch, confiraGet-MigrationBatch.

Etapa 5: converter caixas de correio locais em usuários habilitados para email

Depois de migrar com êxito um lote de caixas de correio, é necessário permitir que os usuários acessem suas mensagens de alguma forma. Um usuário cuja caixa de correio foi migrada agora tem uma caixa de correio local e outra no Microsoft 365. Os usuários que têm uma caixa de correio no Microsoft 365 deixarão de receber novos emails em sua caixa de correio local.

Como você ainda não terminou suas migrações, ainda não está pronto para direcionar todos os usuários para o Microsoft 365 para seu email. Então o que fazer para as pessoas que possuem ambas? O que você pode fazer é alterar as caixas de correio locais que você já tiver migrado para usuários habilitados para email. Ao alterar de uma caixa de correio para um usuário habilitado para email, você pode direcionar o usuário para o Microsoft 365 para seu email em vez de ir para a caixa de correio local.

Outro motivo importante para converter caixas de correio locais em usuários habilitados para email é reter endereços proxy das caixas de correio do Microsoft 365 copiando endereços proxy para os usuários habilitados para email. Isso permite gerenciar usuários baseados em nuvem da sua organização local usando o Active Directory. Além disso, se você decidir desativar sua organização Exchange Server local depois que todas as caixas de correio forem migradas para o Microsoft 365, os endereços proxy copiados para os usuários habilitados para email permanecerão em seu Active Directory local.

Etapa 6: excluir um lote de migração em estágios

Depois que todas as caixas de correio em um lote de migração foram migradas com êxito e você converteu as caixas de correio locais no lote para usuários habilitados para email, você está pronto para excluir um lote de migração em etapas. Verifique se o email está sendo encaminhado para as caixas de correio do Microsoft 365 no lote de migração. Ao excluir um lote de migração em estágios, o serviço de migração limpa todos os registros relacionados ao lote e o exclui.

Para excluir o lote de migração "StagedBatch1" no PowerShell do Exchange Online, execute o comando a seguir.

Remove-MigrationBatch -Identity StagedBatch1

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 StagedBatch1

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.

Etapa7: atribuir licenças a usuários do Microsoft 365

Ative as contas de usuário do Microsoft 365 para as contas migradas atribuindo licenças. Se você não atribuir uma licença, a caixa de correio será desabilitada quando terminar o período de cortesia (30 dias). Para atribuir uma licença no Centro de administração do Microsoft 365, consulte Atribuir ou não atribuir licenças.

Etapa 8: concluir tarefas pós-migração

  • Crie um registro DNS de Descoberta Automática para que os usuários possam facilmente acessar suas caixas de correio. Depois que todas as caixas de correio locais forem migradas para o Microsoft 365, você pode configurar um registro DNS de descoberta automática para sua organização Microsoft 365 para permitir que os usuários se conectem facilmente às novas caixas de correio do Microsoft 365 com o Outlook e clientes móveis. Esse novo registro DNS de descoberta automática precisa usar o mesmo namespace que você está usando para sua organização do Microsoft 365. Por exemplo, se seu namespace baseado na nuvem for cloud.contoso.com, o registro DNS de Descoberta Automática que você precisa criar será autodiscover.cloud.contoso.com.

    O Microsoft 365 usa um registro CNAME para implementar o serviço autodiscover para o Outlook e clientes móveis. O registro CNAME de Descoberta Automática deve conter as seguintes informações:

  • Encerrar servidores locais do Exchange. Depois de verificar se todos os emails estão sendo roteados diretamente para as caixas de correio do Microsoft 365 e você não precisa mais manter sua organização de email local ou não planeja implementar uma solução SSO, você pode desinstalar o Exchange de seus servidores e remover sua organização local do Exchange.

Observação

Desativar o Exchange pode ter consequências indesejadas. Antes de desativar a sua organização local do Exchange, é recomendável que você contate o Suporte da Microsoft.

Para obter mais informações, confira o seguinte: