Migração entre locatários

Artigo
02/12/2025

O recurso de migração de locatário para locatário permite transferir um ambiente de um locatário para outro. Esse recurso oferece suporte a cenários como mesclar vários locatários em um e facilitar aquisições de empresas. Na verdade, o ambiente não se move, mas está vinculado a outro locatário. O ambiente ainda existe, mas não faz mais parte do locatário de origem. É acessível e gerenciado no locatário de destino. Não há nenhuma alteração de interface do usuário ou versão como parte dessa mudança.

Antes de começar

Esteja ciente das observações a seguir antes de começar com uma migração de locatário para locatário.

Tipos de ambiente suportados: somente produção e área restrita.
Tipos de ambiente sem suporte: os tipos de ambiente padrão, desenvolvedor, avaliação e Teams não têm suporte. Government Community Cloud (GCC) para nuvens públicas e vice-versa não são suportadas.
Os componentes sem suporte incluem o Dynamics 365 Customer Voice, o Omnicanal para Customer Service, biblioteca de componentes, Dynamics 365 Customer Insights - Journeys e Dynamics 365 Customer Insights - Data.
Há etapas específicas necessárias para o Power Apps, o Power Automate, o Power Pages e o Microsoft Copilot Studio chamado nas etapas de pré-migração e pós-migração.
Uma organização do Dataverse vinculada a uma organização de finanças e operações não pode ser migrada para um locatário diferente.
Talvez seja necessário reconfigurar alguns aplicativos e definições depois da migração de locatário para locatário, como o Microsoft Dynamics 365 for Outlook, a sincronização do servidor, o SharePoint e outros.
Depois que os usuários são criados e configurados, você deve criar um arquivo de mapeamento de usuário, que é descrito posteriormente neste artigo.
Se o usuário mapeado tiver uma caixa de correio no locatário de destino, a caixa de correio será configurada automaticamente durante a migração. Para todos os outros usuários, você precisará reconfigurar a caixa de correio.
Se a mesma caixa de correio for usada no locatário de destino, test@microsoft.com, então a caixa de correio é usada por padrão. Antes da migração de locatário para locatário, os clientes precisam migrar e configurar suas caixas de correio no locatário de destino.
Se você estiver usando o padrão de domínio onmicrosoft test@sourcecompanyname.onmicrosoft.com, o nome de domínio pós-migração será alterado para test@targetcompanyname.onmicrosoft.com. Os clientes precisam reconfigurar a caixa de correio. Saiba mais sobre como configurar a caixa de correio em Conectar ao Exchange Online.

Pré-requisitos

Certifique-se de concluir os pré-requisitos a seguir antes de iniciar o processo de migração.

Crie usuários no locatário de destino, incluindo:
- Criar usuários no Microsoft 365 e no Microsoft Entra ID.
- Atribuir licenças.
Você deve ter privilégios de administrador da plataforma Power ou administrador Dynamics 365 para executar a migração.
O módulo PowerShell para administradores do Power Platform é o módulo recomendado do PowerShell para interagir com recursos de administrador. Saiba mais em Introdução ao PowerShell para Administradores do Power Platform.

Processo de preparação

Conclua os procedimentos a seguir para o Power Automate, o Power Apps, o Copilot Studio e o Power Pages antes da migração. Você também deve criar um arquivo de mapeamento de usuário.

Preparação Power Automate

Se seus fluxos já estiverem definidos no Dataverse, nenhum trabalho extra será necessário.

Todos os fluxos do Power Automate que devem ser migrados precisam ter suas configurações adicionadas às soluções do Dataverse no ambiente de origem. Saiba mais em Adicionar um fluxo da nuvem existente a uma solução. Isso pode ser feito em massa executando o cmdlet Add-AdminFlowsToSolution.

Preparação Power Apps

Todo Power Apps devem ser exportado manualmente. Não oferecemos suporte à migração de conectores, conexões ou gateways do cliente. Se você tiver algum desses componentes configurados, eles deverão ser reconfigurados manualmente após a migração.

Para aplicativos com reconhecimento de solução:

Para aplicativos que reconhecem soluções, acesse Power Apps, navegue até a página Soluções e exporte todos os aplicativos e soluções. Você pode exportá-los individualmente ou agrupá-los em uma única solução, se ainda não estiverem.
Exclua esses aplicativos com reconhecimento de solução no ambiente após exportá-los.
Os aplicativos pertencentes a soluções gerenciadas só podem ser excluídos excluindo a solução.
Os aplicativos que estão em uma solução não gerenciada podem ser excluídos usando a opção Excluir deste ambiente.

Importante

Aplicativos de tela com reconhecimento de solução, páginas personalizadas ou bibliotecas de componentes que você não exclui de um ambiente antes da migração não funcionarão após a conclusão da migração.

Para aplicativos que tenham reconhecimento de solução.

Acesse o Power Apps e selecione Aplicativos.
Para cada aplicativo que você deseja mover, selecione Mais Comandos e, em seguida, Exportar pacote (versão preliminar).
Insira os detalhes necessários para realizar a exportação do aplicativo e selecione Exportar. Assim que a exportação for concluída, um download é iniciado.

O arquivo resultante contém o pacote do aplicativo que foi selecionado.
Repita essas etapas até que todos os aplicativos tenham sido exportados.
Excluir esses aplicativos sem reconhecimento de solução do ambiente

Um administrador também pode exibir ou excluir aplicativos de tela da lista no portal de administração concluindo as etapas a seguir.

Acesse Centro de administração do Power Platform e selecione o ambiente em Gerenciar.
Na ação Recursos, selecione Power Apps para exibir e exclui-los.

Preparação Copilot Studio

Todos os chatbots do Copilot Studio devem ser exportados manualmente. Alguns componentes dependentes dos chatbots devem ser reconfigurados manualmente durante ou após a migração. Por exemplo, conexões, variáveis do ambiente e conectores personalizados devem ser reconfigurados manualmente durante ou após a migração.

Os chatbots apresentam reconhecimento de solução. Acesse Power Apps, navegue até a página Soluções e exporte todas as soluções do chatbot, individualmente ou agrupados em uma única solução. Saiba mais em Exportar e importar bots usando soluções.

Preparação Power Pages

As etapas a seguir devem ser feitas para cada site em um ambiente.

Entre no ambiente.
Abra o centro de administração.
Exclua o site.

Criar um arquivo de mapeamento de usuário

Crie um arquivo de mapeamento de usuário para o ambiente de origem a ser transferido para o ambiente de destino. É essencial observar que cada ambiente requer um arquivo de mapeamento individual. Certifique-se de que os usuários estejam presentes e autorizados nos locatários de origem e de destino, pois isso é necessário para uma migração bem-sucedida. Os domínios dos usuários podem variar entre origem e destino, desde que estejam ativos.

Crie um arquivo de mapeamento de usuário chamado usermapping.csv.

Observação

O nome do arquivo é sensível a maiúsculas e minúsculas. Verifique se os registros estão separados por uma vírgula, não por ponto-e-vírgula.
Registre com precisão os detalhes dos usuários, incluindo suas IDs de e-mail de origem e destino. Verifique se não há espaço extra antes e depois do cabeçalho. Seu arquivo de mapeamento deve ser semelhante ao seguinte exemplo:

Source Destino

SourceUser@sourcetenant.com DestinationUser@targettenant.com

Source	Destino
`SourceUser@sourcetenant.com`	`DestinationUser@targettenant.com`

Para usuários com acesso completo:

Acesse o ambiente de origem.
Use a Busca Avançada para procurar usuários.
Selecione Usar Exibição Salva > Usuários com Acesso Total, depois selecione Editar Colunas.
Remova todas as colunas, exceto a coluna Nome Completo.
Selecione Adicionar Colunas > Windows Live ID.
Selecione OK > Resultados para ver a lista de usuários com acesso completo.
Selecione todos os registros, selecione Exportar Usuários na faixa de opções e, depois, escolha Planilha Estática.
Siga as etapas de 1 a 7 acima para o locatário de destino, se possível. Agora você deve ter duas planilhas do Excel distintas: uma para a origem e outra para o locatário de destino.
Abra os arquivos do Excel para edição.
Começando com a planilha do Excel de origem, copie os registros na coluna Windows Live ID no Bloco de Notas. Não copie o cabeçalho.
Salve o arquivo do Bloco de Notas.
Insira os UPNs (Windows Live ID) de destino no mesmo documento do Bloco de Notas à direita do UPN de origem correspondente. Certifique-se de separar UPNs de origem e de destino com uma vírgula (,).

Exemplo:
- user001@source.com, user001@destination.com
- user002@source.com, user002@destination.com
- user003@source.com, user003@destination.com
Salve o arquivo como um CSV.

Para usuários com acesso administrativo:

Acesse o ambiente de origem.
Use a Busca Avançada para procurar usuários.
Selecione Usar Exibição Salva > Usuários com Acesso Administrativo e, em seguida, selecione Resultados para ver a lista de usuários com acesso administrativo.
Se você decidir não incluir nenhum desses usuários, pule as etapas a seguir. Caso contrário, para incluir esses usuários no arquivo de mapeamento, faça o seguinte:
1. Encontre os usuários correspondentes no locatário de destino.
2. Certifique-se de que uma licença válida seja atribuída ao usuário de destino no locatário de destino.
  
  Observação
  
  Se o usuário de destino não for atribuído a qualquer licença, a migração falhará.
3. Salve o arquivo CSV que possui usuários com acesso total e usuários com acesso administrativo mapeados.

Migração

Antes de prosseguir com a migração, verifique se você revisou e concluiu o processo de preparação. Depois de concluir o processo de preparação, conclua as seções a seguir para migrar.

Instalar o PowerShell para administradores do Power Platform (administradores de origem e de destino)

O módulo PowerShell para administradores do Power Platform é o módulo recomendado do PowerShell para interagir com recursos de administrador. Para obter informações que o ajudem a começar a usar o módulo de Administradores do PowerShell para o Power Platform, vá para Introdução ao PowerShell para administradores do Power Platform e Instalação do PowerShell para Administradores do Power Platform.

Instale ou atualize o módulo necessário usando um dos seguintes comandos:

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Update-Module -Name Microsoft.PowerApps.Administration.PowerShell

Instalar o Azure PowerShell no Windows (administradores de origem e de destino)

O módulo Azure PowerShell é um módulo cumulativo. A instalação do módulo Azure PowerShell baixa os módulos geralmente disponíveis e disponibiliza seus cmdlets para uso. Saiba mais em Instalar o Azure PowerShell no Windows.

Use o cmdlet Install-Module para instalar o módulo Azure PowerShell:

Install-Module -Name Az -Repository PSGallery -Force

Entre no Microsoft Power Platform (administradores de origem e de destino)

Entre no Microsoft Power Platform. Esta etapa permite que os administradores autentiquem e acessem o ambiente do Power Platform.

Add-PowerAppsAccount

Enviar solicitação de migração (administrador de origem)

Para iniciar uma migração de locatário para locatário, o administrador do Dynamics 365 ou do Power Platform do locatário de origem deve enviar uma solicitação ao locatário de destino usando o comando a seguir e fornecer a ID do nome do ambiente e a ID do locatário.

Você deve ter credenciais do administrador do Power Platform ou do administrador do Dynamics 365 para concluir esta etapa.

TenantToTenant-SubmitMigrationRequest –EnvironmentName {EnvironmentId} -TargetTenantID {TenantID}

Você pode exibir o status e o MigrationID usando o comando a seguir.

TenantToTenant-ViewMigrationRequest

Observação

Registre o MigrationID, que é usado em outros comandos de migração. A ID de Migração do Locatário de Origem é diferente da ID de Migração do Locatário de Destino

Exibir e aprovar a solicitação de migração (administrador de destino)

O administrador do locatário de destino deve executar o seguinte comando para ver todas as solicitações de migração e status. O administrador pode revisar todas as solicitações de migração e opções para aprovar ou rejeitar.

Add-PowerAppsAccount

TenantToTenant-ViewApprovalRequest

TenantToTenant-ManageMigrationRequest -MigrationId {MigrationId from above command to approve or deny}

Depois que uma solicitação for aprovada, o administrador do locatário de destino poderá notificar o administrador do locatário de origem para prosseguir com a próxima etapa da migração.

Gerar uma URL de assinatura de acesso compartilhado (SAS) (administrador de origem)

Essa etapa envolve a criação da URL SAS, que é utilizada posteriormente para carregar o arquivo de mapeamento do usuário. Execute o seguinte comando PowerShell, substituindo EnvironmentId pela ID do ambiente real.

GenerateResourceStorage-PowerAppEnvironment –EnvironmentName {EnvironmentId}

Importante

Verifique se o ambiente não está no Modo de Administração e se o usuário tem a função de Usuário Básico atribuída no ambiente.

Saída de exemplo

Code        :
Description :
Headers     :
Error       :
Errors      :
Internal    : @{sharedAccessSignature=https://dynamics.blob.core.windows.net/20240604t000000z73e18df430fe40059290dsddc25d783?sv=2018-03-28&sr=c&si=SASpolicyXXRRRX}

Carregar o arquivo de mapeamento do usuário (administrador de origem)

A próxima etapa envolve a transferência do arquivo de mapeamento do usuário para a URL SAS estabelecida anteriormente. Para fazer isso, execute os seguintes comandos no Windows PowerShell ISE, garantindo que os parâmetros SASUri e FileToUpload contenham as informações apropriadas sobre seu ambiente. Esta etapa é crucial para o upload do mapeamento dos usuários com precisão no sistema.

Observação

A instalação do módulo Azure é necessária para executar o script mencionado. Conclua as seguintes etapas com o Windows PowerShell ISE.

$SASUri ="Update the SAS Uri from previous step”
$Uri = [System.Uri] $SASUri
 
$storageAccountName = $uri.DnsSafeHost.Split(".")[0]
$container = $uri.LocalPath.Substring(1)
$sasToken = $uri.Query
 
# File to upload
# Note that the file name should be usermapping.csv (case sensitive) with comma separated values.
$fileToUpload = 'C:\filelocation\usermapping.csv'
 
# Create a storage context
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -SasToken $sasToken
 
# Upload the file to Azure Blob Storage
Set-AzStorageBlobContent -File $fileToUpload -Container $container -Context $storageContext -Force

Preparar a migração do ambiente (administrador de origem)

A etapa a seguir envolve a realização de validações abrangentes para garantir que todos os usuários listados no arquivo de mapeamento de usuário estejam verificados e atualmente ativos no locatário de destino.

MigrationId pode ser exibido usando o comando "TenantToTenant-ViewMigrationRequest" no locatário de origem.

TenantToTenant-PrepareMigration 
-MigrationId {MigrationId} 
-TargetTenantId {TargetTenantId} 
-ReadOnlyUserMappingFileContainerUri {SasUri}

Observação

Ao passar o valor SASUri, você deve fornecer o parâmetro assim: https://dynamics.blob.core.windows.net/20240604t000000z73e18df430fe40059290dsddc25d783.

Saída de exemplo

Code        : 202
Description : Accepted

A duração desta etapa varia dependendo do número de usuários no arquivo de mapeamento de usuário. Você pode monitorar o andamento desta etapa usando o comando TenantToTenant-GetStatus, fornecido abaixo.

Verificar status (administrador de origem)

TenantToTenant-GetMigrationStatus -MigrationId {MigrationId}

Saída de exemplo

Valide a Migração de Locatário para Locatário: Em execução
Valide a Migração de Locatário para Locatário: Bem-sucedido
Falha na Validação, os erros são atualizados no blob aqui: SASURI

Erros e como resolvê-los

Se você receber um erro que diz: O arquivo de mapeamento de usuário fornecido para a migração de Locatário para Locatário é inválido, verifique se o nome do arquivo de mapeamento de usuário está correto e se o arquivo de mapeamento de usuário tem uma vírgula para separar valores.
Linha '{números de linha}' têm o mesmo '{emailID}': verifique se não há entradas duplicadas.
Formato de Email Inválido '{emailid}': verifique se o formato de email está correto para testuser@tenantdomain.com.
O destino na linha '{linenumber}' é igual ao Id do email de origem: verifique se o Email de Destino é diferente do Email de origem.
Cada linha deve ter exatamente duas colunas: '{números de linha}': certifique-se de que cada linha tenha apenas duas colunas: as colunas de origem e de destino. Remova todas as vírgulas extras, se houver.

Depois de corrigir erros de mapeamento de usuário, você precisa recarregar o arquivo de mapeamento de usuário usando o mesmo URI SAS.

Baixar o relatório de erros (administrador de origem)

Se houver erros no arquivo de mapeamento do usuário, há uma opção para baixar um relatório de erros. Isso pode ser feito copiando e colando diretamente o SasUrl fornecido no comando Tenant-To-Tenant-GetMigrationStatus ou usando os seguintes comandos que usam a URI do SAS da etapa anterior, verifique o status e o local desejado para baixar o relatório de erros.

Conclua as seguintes etapas.

Execute o seguinte comando com o ISE do Windows PowerShell.

Import-Module Az.Storage 
# Define the SAS URI of the blob
$sasUri = " Update the SAS Uri from previous step "
# Define the path where the blob will be downloaded
$destinationPath = "C:\Downloads\Failed\"
# Split the SAS URI on the '?' character to separate the URL and the SAS token
$url, $sasToken = $sasUri -split '\?', 2
$containerName = $url.Split('/')[3]
$storageAccountName = $url.Split('/')[2].Split('.')[0]
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -SasToken $sasToken
Get-AzStorageBlobContent -Blob "usermapping.csv" -Container $containerName -Destination $destinationPath -Context $storageContext

Corrija os problemas no arquivo de mapeamento do usuário.
Carregue o arquivo usando as etapas em [Carregar o arquivo de mapeamento do usuário (administrador de origem)](#upload-the-user-mapping-file-(source-admin).

Depois de concluir com êxito o procedimento Preparar a migração do ambiente (administrador de origem), você pode prosseguir com o procedimento Migrar o ambiente (administrador de origem) para migrar o ambiente. Execute a migração nos próximos sete dias. Se você não concluir a migração nos próximos sete dias, deverá começar com o procedimento Preparar a migração do ambiente (administrador de origem) novamente.

Migrar o ambiente (administrador de origem)

O MigrationId pode ser exibido usando o comando TenantToTenant-ViewMigrationRequest no locatário de origem.

TenantToTenant-MigratePowerAppEnvironment
-MigrationId {MigrationId}
-TargetTenantId {TargetTenantId}

Obter status (administrador de origem)

TenantToTenant-GetMigrationStatus -EnvironmentName {EnvironmentId}

Saída de exemplo

Migrar Ambiente: Em execução
Migrar Ambiente: Bem-sucedido

Observação

Se você encontrar algum problema ao executar os comandos acima, envie uma solicitação de suporte para obter ajuda.

Processo de pós-migração

Depois de mover os ambientes para outro locatário:

O URL do ambiente, a ID da organização (OrgID) e o nome não mudam.
O ambiente de origem não tem Dataverse.
Os usuários não incluídos no arquivo de mapeamento não serão migrados e mapeados após a migração.

Conclua os procedimentos a seguir para o Power Automate, o Power Apps, o Copilot Studio, o Power Pages.

Processo de pós-migração para o Power Automate

Após a conclusão da migração, percorra a seção Revisar componentes como uma lista de verificação para obter fluxos e outros componentes ajustados e ativados. As principais etapas são:

Criar conexões para todas as referências de conexão.
Inicie todos os fluxos, incluindo iniciar fluxos filho antes dos fluxos pai.
Para quaisquer fluxos acionados por HTTP, recupere a nova URL e coloque-a em quaisquer aplicativos ou fluxos de chamada para atualizar essas referências.

Processo de pós-migração para o Power Apps

Para aplicativos com reconhecimento de solução:

Selecione o novo ambiente no Power Apps e navegue até a página Soluções.
Selecione Importar e use o seletor de arquivos para selecionar os pacotes exportados da etapa acima.
Confirme se a importação foi concluída com êxito, verificando o conteúdo da solução no ambiente migrado.

Para aplicativos que tenham reconhecimento de solução.

Vá para Power Apps.
Selecione o novo ambiente da lista suspensa Ambiente.
Selecione Apps.
Selecione Importar aplicativo de tela.
Faça upload do arquivo do pacote do aplicativo.
Conclua todas as seleções de opção de importação e, em seguida, selecione Importar.
Repita essas etapas até que todos os aplicativos tenham sido importados.

Processo de pós-migração para o Copilot Studio

Selecione o novo ambiente no Power Apps e navegue até a página Soluções.
Selecione Importar e use o seletor de arquivos para selecionar os pacotes exportados da etapa acima.
Confirme se a importação foi concluída com êxito, verificando o conteúdo da solução no ambiente migrado.

Processo de pós-migração para o Power Pages

As etapas a seguir devem ser concluídas para cada site no ambiente.

Entre no ambiente.
Abra o centro de administração.
Provisione o site com o mesmo tipo e idioma do portal.

Depois de concluir todas as etapas acima e a migração, você poderá validar o ambiente no locatário de destino e, posteriormente, excluir o ambiente de origem no Centro de administração da plataforma Power.

Perguntas frequentes

As operações em segundo plano são habilitadas durante a migração de locatário para locatário? O modo de administração é habilitado durante a migração de locatário para locatário, portanto, as operações em segundo plano não são executadas. Saiba mais em Modo de administração.

Podemos migrar todos os usuários da organização do Dataverse? Podemos migrar todos os usuários da organização do Dataverse somente se houver usuários no locatário de destino. Por exemplo:

user001@source.com, user001@destination.comuser002@source.com, user002@destination.com

Compartilhar via

Migração entre locatários

Antes de começar

Pré-requisitos

Processo de preparação

Preparação Power Automate

Preparação Power Apps

Para aplicativos com reconhecimento de solução:

Para aplicativos que tenham reconhecimento de solução.

Preparação Copilot Studio

Preparação Power Pages

Criar um arquivo de mapeamento de usuário

Para usuários com acesso completo:

Para usuários com acesso administrativo:

Migração

Instalar o PowerShell para administradores do Power Platform (administradores de origem e de destino)

Instalar o Azure PowerShell no Windows (administradores de origem e de destino)

Entre no Microsoft Power Platform (administradores de origem e de destino)

Enviar solicitação de migração (administrador de origem)

Exibir e aprovar a solicitação de migração (administrador de destino)

Gerar uma URL de assinatura de acesso compartilhado (SAS) (administrador de origem)

Saída de exemplo

Carregar o arquivo de mapeamento do usuário (administrador de origem)

Preparar a migração do ambiente (administrador de origem)

Saída de exemplo

Verificar status (administrador de origem)

Saída de exemplo

Erros e como resolvê-los

Baixar o relatório de erros (administrador de origem)

Migrar o ambiente (administrador de origem)

Obter status (administrador de origem)

Saída de exemplo

Processo de pós-migração

Processo de pós-migração para o Power Automate

Processo de pós-migração para o Power Apps

Para aplicativos com reconhecimento de solução:

Para aplicativos que tenham reconhecimento de solução.

Processo de pós-migração para o Copilot Studio

Processo de pós-migração para o Power Pages

Perguntas frequentes

Comentários

Recursos adicionais