Migrações entre inquilinos

Artigo
02/12/2025

A caraterística de migração de inquilino para inquilino permite-lhe transferir um ambiente de um inquilino para outro. Esta caraterística suporta cenários, como a união de vários inquilinos num único e a facilitação de aquisições de empresas. Na verdade, o ambiente não se move, mas é associado a outro inquilino. O ambiente ainda existe, mas já não faz parte do inquilino de origem. Está acessível e é gerido sob o inquilino de destino. Não existem alterações à interface de utilizador ou à versão como parte desta mudança.

Antes de começar

Tenha em atenção as seguintes notas antes de começar a migração de inquilino para inquilino.

Tipos de ambiente suportados: só produção e sandbox.
Tipos de ambiente não suportados: os tipos de ambiente predefinido, de programação, de avaliação e do Teams não são suportados. A Nuvem da Comunidade Governamental (GCC) para nuvens públicas e vice-versa não é suportada.
Os componentes não suportados incluem o Dynamics 365 Customer Voice, o Omnicanal para Customer Service, a biblioteca de componentes, o Dynamics 365 Customer Insights - Journeys e o Dynamics 365 Customer Insights - Data.
Há passos específicos necessárias para o Power Apps, o Power Automate, o Power Pages e o Microsoft Copilot Studio destacados nos passos de pré e pós-migração.
Uma organização do Dataverse associada uma organização de finanças e operações não pode ser migrada para um inquilino diferente.
Poderá ser necessário reconfigurar algumas aplicações e definições após a migração de inquilino para inquilino, tal como o Microsoft Dynamics 365 for Outlook, a sincronização do lado do servidor, o SharePoint e outros.
Depois de os utilizadores serem criados e configurados, tem de criar um ficheiro de mapeamento de utilizador, que é descrito mais adiante neste artigo.
Se o utilizador mapeado tiver uma caixa de correio no inquilino de destino, a caixa de correio é automaticamente configurada durante a migração. Para todos os outros utilizadores, tem de reconfigurar a caixa de correio.
Se a mesma caixa de correio for utilizada no inquilino de destino, test@microsoft.com, a caixa de correio é usada por predefinição. Antes da migração de inquilino para inquilino, os clientes precisam de migrar e configurar as respetivas caixas de correio no inquilino de destino.
Se estiver a usar o domínio onmicrosoft predefinido, test@sourcecompanyname.onmicrosoft.com, o nome de domínio pós-migração será alterado para test@targetcompanyname.onmicrosoft.com. Os clientes têm de configurar a caixa de correio. Obtenha mais informações sobre a configuração da caixa de correio em Ligar ao Exchange Online.

Pré-requisitos

Certifique-se de que tem satisfaz os seguintes pré-requisitos antes de começar o processo de migração.

Crie utilizadores no inquilino de destino, incluindo:
- Criar utilizadores no Microsoft 365 e no Microsoft Entra ID.
- Atribuir licenças.
Tem de ter privilégios de administrador do Power Platform ou do Dynamics 365 para efetuar a migração.
O módulo PowerShell para Administradores do Power Platform é o módulo do PowerShell recomendado para interagir com as capacidades de administração. Obtenha mais informações em Começar a utilizar o 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. Também tem de criar um ficheiro de mapeamento de utilizador.

Preparar Power Automate

Se os fluxos já estiverem definidos no Dataverse, não será necessário nenhum trabalho adicional.

Todos os fluxos do Power Automate que devem ser migrados precisam de ter as respetivas definições adicionadas às soluções do Dataverse no ambiente de origem. Mais informações em Adicionar um fluxo de cloud existente a uma solução. Isto pode ser feito em massa ao executar o cmdlet Add-AdminFlowsToSolution.

Preparar Power Apps

Todos os Power Apps têm de ser exportados manualmente. Não suportamos a migração de conectores de cliente, ligações nem de gateways. Se tiver algum destes componentes configurados, estes têm de ser reconfigurados manualmente após a migração.

Para aplicações com suporte de soluções:

Para aplicações com suporte de soluções, aceda a Power Apps, navegue até à página Soluções e exporte todas as aplicações e soluções. Pode exportá-los individualmente ou agrupá-los numa única solução, se ainda não o foram.
Elimine estas aplicações com deteção de soluções no ambiente depois de as exportar.
As aplicações pertencentes a soluções geridas só podem ser eliminadas através da eliminação da solução.
As aplicações que estão numa solução não gerida podem ser eliminadas usando a opção Eliminar deste ambiente.

Importante

Aplicações de tela com suporte de soluções, páginas personalizadas ou bibliotecas de componentes que não elimina de um ambiente antes da migração não vão funcionar depois de concluída a migração.

Para aplicações sem suporte para soluções:

Aceda a Power Apps e, em seguida, selecione Aplicações.
Para cada aplicação que pretende mover, selecione Mais Comandos e, em seguida, selecione Exportar pacote (pré-visualização).
Introduza os detalhes necessários para efetuar a exportação da aplicação e, em seguida, selecione Exportar. Uma vez concluída a exportação, inicia-se uma transferência.

O ficheiro resultante contém o pacote de aplicações que foi selecionado.
Repita estes passos até que todas as aplicações tenham sido exportadas.
Eliminar estas aplicações sem suporte de soluções do ambiente

Um administrador também pode ver ou eliminar aplicações tela da lista no portal de administração ao concluir os passos seguintes.

Aceda ao centro de administração do Power Platform e, em seguida, selecione o ambiente em Gerir.
Na ação Recursos, selecione Power Apps para ver e eliminá-los.

Preparar Copilot Studio

Todos os chatbots do Copilot Studio têm de ser exportados manualmente. Alguns componentes dependentes de chatbots tem de ser reconfigurados manualmente durante ou depois da migração. Por exemplo, ligações, variáveis de ambiente e conectores personalizados têm de ser reconfigurados manualmente durante ou depois da migração.

Os chatbots têm suporte para soluções. Aceda a Power Apps, navegue para a página Soluções e exporte todas as soluções dos chatbot, individualmente ou agrupe-as numa única solução. Obtenha mais informações em Exportar e importar bots utilizando soluções.

Preparar Power Pages

Os passos que se seguem têm de ser efetuados para cada site num ambiente.

Inicie sessão no ambiente.
Abra o centro de administração.
Eliminar o site.

Criar um ficheiro de mapeamento de utilizador

Crie um ficheiro de mapeamento de utilizador para o ambiente de origem a ser transferido para o ambiente de destino. É essencial observar que cada ambiente requer um ficheiro de mapeamento individual. Certifique-se de que os utilizadores estão presentes e autorizados nos inquilinos de origem e de destino, pois isto é obrigatório para uma migração bem-sucedida. Os domínios dos utilizadores podem variar entre a origem e o destino, desde que estejam ativos.

Crie um ficheiro de mapeamento de utilizador chamado usermapping.csv.

Nota

O nome do ficheiro é sensível às maiúsculas e minúsculas. Certifique-se de que os registos estão separados por vírgula e não por ponto e vírgula.
Registe com precisão os detalhes dos utilizadores, incluindo os IDs de e-mail de origem e de destino. Certifique-se de que não há espaços adicionais antes e depois do cabeçalho. O seu ficheiro de mapeamento deve parecer-se com o exemplo seguinte:

Source Destino

SourceUser@sourcetenant.com DestinationUser@targettenant.com

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

Para utilizadores com acesso total:

Aceda ao ambiente de origem.
Utilize a Localização Avançada para procurar por utilizadores.
Selecione Utilizar Vista Guardada > Utilizadores com Acesso Total e, em seguida, 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 utilizadores com acesso total.
Selecione todos os registos, selecione Exportar Utilizadores no friso e, em seguida, escolha Folha de Cálculo Estática.
Siga os passos 1-7 acima para o inquilino de destino, se possível. Deve agora ter duas folhas Excel separadas: uma para o inquilino de origem e outra para o de destino.
Abra os ficheiros Excel para edição.
A partir da folha Excel de origem, copie os registos sob a coluna Windows Live ID no Bloco de Notas. Não copie o cabeçalho.
Guarde o ficheiro do Bloco de Notas.
Introduza o Windows Live ID (UPNs) de destino no mesmo documento do Bloco de Notas à direita da UPN de origem correspondente. Certifique-se de que separa as 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
Guarde o ficheiro como um CSV.

Para utilizadores com acesso administrativo:

Aceda ao ambiente de origem.
Utilize a Localização Avançada para procurar por utilizadores.
Selecione Utilizar Vista Guardada > Utilizadores com Acesso Administrativo e, em seguida, selecione Resultados para ver a lista de utilizadores com acesso administrativo.
Se decidir não incluir nenhum destes utilizadores, ignore os passos que se seguem. Caso contrário, para incluir estes utilizadores no ficheiro de mapeamento, faça o seguinte:
1. Encontre os utilizadores correspondentes no inquilino de destino.
2. Certifique-se de que uma licença válida é atribuída ao utilizador de destino no inquilino de destino.
  
  Nota
  
  Se o utilizador de destino não tiver nenhuma licença atribuída, a migração falhará.
3. Guarde o ficheiro CSV que tem utilizadores com acesso total e utilizadores com acesso administrativo mapeados.

Migração

Antes de prosseguir com a migração, certifique-se de que reviu e concluiu o processo de preparação. Depois de concluir o processo de preparação, conclua as secçõ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 do PowerShell recomendado para interagir com as capacidades de administração. Para obter informações que o ajudem a começar a utilizar o módulo PowerShell para Administradores do Power Platform, aceda a Introdução ao PowerShell para Administradores do Power Platform e a Instalar o 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 de rollup. A instalação do módulo Azure PowerShell transfere os módulos geralmente disponíveis e disponibiliza os respetivos cmdlets para utilização. Obtenha mais informações 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

Iniciar sessão no Microsoft Power Platform (administradores de origem e de destino)

Iniciar sessão no Microsoft Power Platform. Este passo permite que os administradores se autentiquem e acedam ao ambiente do Power Platform.

Add-PowerAppsAccount

Submeter pedido de migração (administrador de origem)

Para iniciar uma migração de inquilino para inquilino, o administrador Dynamics 365 ou do Power Platform do inquilino de origem tem de submeter um pedido ao inquilino de destino através do comando a seguir e fornecer o ID do nome do ambiente e o ID do inquilino.

Tem de ter credenciais de administrador do Power Platform ou de administrador Dynamics 365 para concluir este passo.

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

Pode ver o estado e o MigrationID usando o comando a seguir.

TenantToTenant-ViewMigrationRequest

Nota

Registe o MigrationID, o qual é usado noutros comandos de migração. O MigrationID do Inquilino de Origem é diferente do MigrationID do Inquilino de Destino

Ver e aprovar pedido de migração (administrador de destino)

O administrador do inquilino de destino deve executar o seguinte comando para ver todos os pedidos e o estado da migração. O administrador pode rever todos os pedidos 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 de um pedido ser aprovado, o administrador do inquilino de destino pode notificar o administrador do inquilino de origem para prosseguir com o próximo passo da migração.

Gerar um URL de assinatura de acesso partilhado (SAS) (administrador de origem)

Este passo envolve a criação do URL SAS, que é utilizado posteriormente para carregar o ficheiro de mapeamento de utilizador. Execute o seguinte comando do PowerShell, substituindo EnvironmentId pelo ID do ambiente real.

GenerateResourceStorage-PowerAppEnvironment –EnvironmentName {EnvironmentId}

Importante

Verifique se o ambiente não está no Modo de Administrador e se o utilizador tem a função de Utilizador 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 ficheiro de mapeamento de utilizador (administrador de origem)

O próximo passo envolve a transferência do ficheiro de mapeamento de utilizador para o URL SAS estabelecido anteriormente. Para tal, execute os seguintes comandos no Windows PowerShell ISE, garantindo que os parâmetros SASUri e FileToUpload contêm as informações apropriadas sobre o seu ambiente. Este passo é crucial para carregar o mapeamento dos utilizadores com precisão no sistema.

Nota

A instalação do módulo Azure é obrigatória para executar o script mencionado. Conclua os passos a seguir 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)

O passo a seguir envolve a realização de validações abrangentes para garantir que cada utilizador listado no ficheiro de mapeamento de utilizador é verificado e está atualmente ativo no inquilino de destino.

O MigrationId pode ser visto usando o comando "TenantToTenant-ViewMigrationRequest" no inquilino de origem.

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

Nota

Ao transmitir o valor SASUri, tem de fornecer o parâmetro desta forma: https://dynamics.blob.core.windows.net/20240604t000000z73e18df430fe40059290dsddc25d783.

Saída de exemplo

Code        : 202
Description : Accepted

A duração deste passo varia de acordo com o número de utilizadores no ficheiro de mapeamento de utilizador. Pode monitorizar o progresso deste passo ao usar o comando TenantToTenant-GetStatus, fornecido abaixo.

Verificar estado (administrador de origem)

TenantToTenant-GetMigrationStatus -MigrationId {MigrationId}

Saída de exemplo

Validar Migração de Inquilino para Inquilino: Em execução
Validar Migração de Inquilino para Inquilino: Bem-sucedida
Falha ao Validar. Os erros foram atualizados no blob aqui: SASURI

Erros e como resolvê-los

Se receber um erro que diz, O Ficheiro de mapeamento de utilizador fornecido para a migração de Inquilino para Inquilino é inválido, verifique se o nome do ficheiro de mapeamento de utilizador está correto e se o ficheiro de mapeamento de utilizador tem uma vírgula para separar valores.
As linhas "{números de linha}" têm o mesmo "{emailID}": certifique-se de que não há entradas duplicadas.
Formato de E-mail Inválido "{emailid}": verifique se o formato do e-mail está correto para testuser@tenantdomain.com.
O destino na linha "{linenumber}" é o mesmo que o emailId de origem: certifique-se de que o E-mail de Destino é diferente do E-mail de Origem.
Cada linha tem de ter exatamente duas colunas: "{números de linha}": certifique-se de que cada linha tem apenas duas colunas: as colunas de origem e de destino. Remova as vírgulas adicionais, se houver.

Depois de corrigir erros de mapeamento de utilizador, precisa de voltar a carregar o ficheiro de mapeamento de utilizador usando o mesmo URI SAS.

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

Se houver algum erro no ficheiro de mapeamento de utilizador, há uma opção para transferir um relatório de erros. Isto pode ser feito copiando e colando diretamente o SasUrl fornecido no comando Tenant-To-Tenant-GetMigrationStatus ou usando os seguintes comandos que usam o URI SAS do passo anterior Verificar estado e a localização pretendida para transferir o relatório de erros.

Conclua os seguintes passos.

Execute o seguinte comando com o Windows PowerShell ISE.

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 ficheiro de mapeamento de utilizador.
Volte a carregar o ficheiro usando os passos em [Carregar o ficheiro de mapeamento de utilizador (administrador de origem)](#upload-the-user-mapping-file-(source-admin).

Depois de concluir com êxito Preparar a migração do ambiente (administrador de origem), pode prosseguir com o procedimento Migrar o ambiente (administrador de origem) para migrar o ambiente. Efetue a migração nos sete dias seguintes. Se não concluir a migração nos sete dias seguintes, terá de 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 visto usando o comando TenantToTenant-ViewMigrationRequest no inquilino de origem.

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

Obter estado (administrador de origem)

TenantToTenant-GetMigrationStatus -EnvironmentName {EnvironmentId}

Saída de exemplo

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

Nota

Se encontrar algum problema ao executar os comandos acima, submeta um pedido de suporte para obter ajuda.

Processo de pós-migração

Depois de mudar ambiente para outro inquilino:

O URL do ambiente, o ID da organização (OrgID) e o nome não mudam.
O ambiente de origem não tem o Dataverse.
Os utilizadores não incluídos no ficheiro 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 e o Power Pages.

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

Após a conclusão da migração, percorra a secção Rever componentes como uma lista de verificação para ajustar e ativar fluxos e outros componentes. Os passos principais são:

Criar ligações para todas as referências de ligação.
Inicie todos os fluxos, incluindo iniciar fluxos subordinados antes dos fluxos principais.
Para quaisquer fluxos acionados por HTTP, obtenha o novo URL e coloque-o em quaisquer aplicações ou fluxos de chamada para atualizar essas referências.

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

Para aplicações com suporte de soluções:

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

Para aplicações sem suporte para soluções:

Aceder a Power Apps.
Selecione o novo ambiente na lista pendente de ambientes.
Selecione Aplicações.
Selecione Importar aplicação de tela.
Carregue o ficheiro de pacote aplicações.
Complete todas as seleções de opção de importação e, em seguida, selecione Importar.
Repita estes passos até que todas as aplicações tenham sido importadas.

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

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

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

Os passos que se seguem têm de ser concluídos para cada site no ambiente.

Inicie sessão no ambiente.
Abra o centro de administração.
Aprovisionar o site com o mesmo tipo de portal e idioma.

Depois de concluir todos os passos acima e a migração, pode validar o ambiente no inquilino de destino e, posteriormente, eliminar o ambiente de origem no centro de administração do Power Platform.

Perguntas mais frequentes

As operações de fundo são ativadas durante a migração de inquilino para inquilino? O modo de administração é ativado durante a migração de inquilino para inquilino, por isso, as operações de fundo não são executadas. Obtenha mais informações em Mode de administração.

Podemos migrar todos os utilizadores da organização do Dataverse? Só podemos migrar todos os utilizadores da organização do Dataverse se os utilizadores existirem no inquilino de destino. Por exemplo:

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

Partilhar via

Migrações entre inquilinos

Antes de começar

Pré-requisitos

Processo de preparação

Preparar Power Automate

Preparar Power Apps

Para aplicações com suporte de soluções:

Para aplicações sem suporte para soluções:

Preparar Copilot Studio

Preparar Power Pages

Criar um ficheiro de mapeamento de utilizador

Para utilizadores com acesso total:

Para utilizadores 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)

Iniciar sessão no Microsoft Power Platform (administradores de origem e de destino)

Submeter pedido de migração (administrador de origem)

Ver e aprovar pedido de migração (administrador de destino)

Gerar um URL de assinatura de acesso partilhado (SAS) (administrador de origem)

Saída de exemplo

Carregar o ficheiro de mapeamento de utilizador (administrador de origem)

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

Saída de exemplo

Verificar estado (administrador de origem)

Saída de exemplo

Erros e como resolvê-los

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

Migrar o ambiente (administrador de origem)

Obter estado (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 aplicações com suporte de soluções:

Para aplicações sem suporte para soluções:

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

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

Perguntas mais frequentes

Comentários

Recursos adicionais