Migrações entre inquilinos

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 ao seguinte antes de começar a migração de inquilino para inquilino.

• Tipos de ambiente suportados: Somente ambientes de produção e sandbox são suportados.
• Tipos de ambiente não suportados: ambientes padrão, de desenvolvedor, de avaliação e do Teams não são suportados. Nuvem da Comunidade Governamental (GCC) para nuvens públicas e vice-versa também não são suportadas.
• Não há suporte para os seguintes componentes: Dynamics 365 Customer Voice, Omnichannel for Customer Service, biblioteca de componentes, Dynamics 365 Customer Insights - Jornadas e Dynamics 365 Customer Insights - Dados.
• Os passos específicos necessárias para o Power Apps, o Power Automate, o Power Pages e o Microsoft Copilot Studio estão 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 Dynamics 365 for Outlook, sincronização do lado do servidor, 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 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 com o Power Platform ou o 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. Você também deve criar um arquivo de mapeamento de usuário.

Preparar o 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 o Power Apps

Todos os Power Apps devem 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 deteção de soluções

1. 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.

2. Elimine estas aplicações com deteção de soluções no ambiente depois de as exportar.

3. As aplicações pertencentes a soluções geridas só podem ser eliminadas através da eliminação da solução.

4. 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

1. Aceda ao Power Apps e, em seguida, selecione Aplicações.

2. Para cada aplicação que pretende mover, selecione Mais Comandos e, em seguida, selecione Exportar pacote (pré-visualização).

3. 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.

4. Repita estes passos até que todas as aplicações tenham sido exportadas.

5. Eliminar estas aplicações sem suporte de soluções do ambiente:

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

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

Preparar o 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 chatbots, individualmente ou agrupadas numa única solução. Obtenha mais informações em Exportar e importar bots utilizando soluções.

Preparar o Power Pages

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

1. Inicie sessão no ambiente.
2. Abra o centro de administração.
3. Elimine 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 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.

1. Crie um arquivo de mapeamento de usuário 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.

2. 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

Para utilizadores com acesso total

1. Aceda ao ambiente de origem.

2. Utilize a Localização Avançada para procurar por utilizadores.

3. Selecione Utilizar Vista Guardada>Utilizadores com Acesso Total e, em seguida, selecione Editar Colunas.

4. Remova todas as colunas, exceto a coluna Nome Completo.

5. Selecione Adicionar Colunas>Windows Live ID.

6. Selecione OK>Resultados para ver a lista de utilizadores com acesso total.

7. Selecione todos os registos, selecione Exportar Utilizadores no friso e, em seguida, escolha Folha de Cálculo Estática.

8. 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.

9. Abra os ficheiros Excel para edição.

10. 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.

11. Guarde o ficheiro do Bloco de Notas.

12. 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

13. Guarde como um ficheiro CSV.

Para utilizadores com acesso administrativo

1. Aceda ao ambiente de origem.
2. Utilize a Localização Avançada para procurar por utilizadores.
3. Selecione Utilizar Vista Guardada>Utilizadores com Acesso Administrativo e, em seguida, selecione Resultados para ver a lista de utilizadores com acesso administrativo.
4. 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 revê e conclui 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 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 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)

Inicie 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 do 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

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.

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

Esta etapa envolve a criação da URL SAS, que é usada posteriormente para carregar o arquivo de mapeamento do usuário. Execute o seguinte comando do PowerShell, substituindo EnvironmentId pelo ID do ambiente real e FileLocation pelo local do arquivo real.

TenantToTenant-UploadUserMappingFile –EnvironmentName {EnvironmentId} -UserMappingFilePath {FileLocation}

Certifique-se de que copia o valor do ContainerUri do Ficheiro UserMapping Só de Leitura devolvido pelo comando. Este URI SAS é obrigatório como o parâmetro -ReadOnlyUserMappingFileContainerUri no comando TenantToTenant-PrepareMigration.

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

A etapa a seguir envolve a realização de validações abrangentes para garantir que cada usuário listado no arquivo de mapeamento de usuário seja verificado e atualmente ativo no locatário de destino.

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

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

Saída de exemplo

Code        : 202
Description : Accepted

A duração desta etapa varia de acordo com o número de usuários no arquivo de mapeamento de usuário. 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 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.
• A linha '{números de linha}' tem o mesmo '{email ID}': certifique-se de que não há entradas duplicadas.
• Formato de e-mail inválido '{email ID}': Verifique se o formato de e-mail está correto para testuser@tenantdomain.com.
• O destino na linha '{número da linha}' é o mesmo que o ID do e-mail 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: '{line numbers}': certifique-se de que cada linha tem apenas duas colunas: as colunas de origem e de destino. Remova as vírgulas adicionais.

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

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

Se houver algum erro no arquivo de mapeamento do usuário, há uma opção para baixar um relatório de erros. Isto pode ser feito ao copiar e colar diretamente o SasUrl fornecido no comando Tenant-To-Tenant-GetMigrationStatus no seu browser ou usando os seguintes comandos que usam o URI SAS do passo anterior para verificar o estado e a localização pretendidos para transferir o relatório de erros.

Conclua os seguintes passos:

1. 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 
   

2. Corrija os problemas no arquivo de mapeamento do usuário.

3. Volte a carregar o ficheiro usando os passos em Carregar o ficheiro de mapeamento de utilizador (administrador de origem).

Depois de concluir com êxito o procedimento Preparar a migração do ambiente (administrador de origem), você pode continuar 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 -MigrationId {MigrationId}

Saída de exemplo

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

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, reveja os componentes importados e efetue os passos a seguir para garantir que os fluxos e outros ativos funcionam corretamente:

1. Crie ou mapeie ligações para todas as referências de ligação.
   • Abra a solução para o ambiente de destino.
   • Navegue até as referências de ligação e autentique novamente ou associe cada uma delas a uma ligação existente.
2. Ative todos os fluxos.
   • Os fluxos importados estão desativados por predefinição.
   • Para evitar erros, inicie quaisquer fluxos subordinados antes de ativar os fluxos principais que os chamem.
3. Atualize os URLs de acionadores HTTP.
   • Os fluxos acionados por HTTP geram um novo URL após a importação.
   • Atualize todas as aplicações de chamadas, fluxos principais ou sistemas externos para usar o novo URL.

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

Para aplicações com deteção de soluções

1. Selecione o novo ambiente do Power Apps e navegue para a página Soluções.
2. Selecione Importar e use o seletor de ficheiros para selecionar os pacotes exportados do passo acima.
3. 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

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

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

1. Selecione o novo ambiente do Power Apps e navegue para a página Soluções.
2. Selecione Importar e use o seletor de ficheiros para selecionar os pacotes exportados do passo acima.
3. 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.

1. Inicie sessão no ambiente.
2. Abra o centro de administração.
3. 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. Posteriormente, pode 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.

Todos os usuários da organização Dataverse podem ser migrados?

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.com

user002@source.com, user002@destination.com

Que ambientes são suportados para migração?

Só são suportados ambientes de produção e de sandbox. Os ambientes predefinido, de programador, de avaliação e do Teams não são suportados.

O ambiente será movido fisicamente para o novo inquilino?

Não O ambiente permanece no lugar, mas o Dataverse Organization é movido para o inquilino de destino. Já não faz parte do inquilino de origem e é gerido sob o novo ambiente no inquilino de destino. Os dados armazenados no Dataverse continuam a ser armazenados no ambiente do seu tenant. O ambiente órfão deve ser eliminado quando a migração de inquilino para inquilino estiver concluída e for confirmado que os dados já não são necessários no inquilino de origem.

Existem quaisquer componentes que não sejam totalmente suportados?

Saiba mais em Antes de começar a entender quais componentes são suportados e quais componentes não são suportados.

O que acontece com as configurações da caixa de correio?

Se o usuário mapeado (mencionado no arquivo de mapeamento de usuário) tiver uma caixa de correio no locatário de destino, ela será configurada automaticamente. Caso contrário, é necessária reconfiguração manual.

Como inicio uma migração?

O administrador do Dynamics 365 ou do Power Platform do inquilino de origem tem de submeter um pedido usando comandos do PowerShell com o nome do ambiente, o ID e o ID do inquilino. Consulte os comandos acima.

Existe uma opção de IU de gestão autónoma?

Yes. Após a aprovação de TenantToTenant-SubmitMigrationRequest –EnvironmentName {EnvironmentId} -TargetTenantID {TenantID} no inquilino de destino, fica disponível na página do ambiente uma opção de IU para mover o ambiente.