Migrar configuração do site

Power Pages O desenvolvimento de um site envolve várias personalizações e configurações para obter a experiência desejada para usuários finais do site.

Depois de concluir o desenvolvimento ou a configuração da instância do site, convém migrar sua configuração de site mais recente do desenvolvimento para o teste ou os ambientes de produção.

A migração envolve exportar a configuração existente do ambiente de origem do Microsoft Dataverse e, em seguida, importá-la para o ambiente de destino do Dataverse.

Preparar o ambiente de destino

Prepare o ambiente de destino se você estiver usando o modelo de dados padrão. Um ambiente que usa o modelo de dados aprimorado não requer essas etapas. Você pode continuar transferindo a configuração do site.

Observação

A preparação do ambiente de destino é um processo único. Você precisa provisionar um novo site para instalar as soluções de Power Pages gerenciadas no Dataverse e configurar o aplicativo Web Power Pages. Esse processo também instala metadados padrão do site que são substituídos pelos metadados do site do seu ambiente de origem.
Certifique-se de que o tamanho máximo de anexo do ambiente de destino esteja definido para o mesmo tamanho ou maior do seu ambiente de origem.
A configuração Tamanho máximo do arquivo na guia email de configurações do sistema na caixa de diálogo de configurações do sistema do ambiente determina o tamanho máximo de arquivos.
Observe a diferença entre sites de desenvolvedor, de avaliação e de produção e ambientes de desenvolvedor, de avaliação, de sandbox e de produção.
Você pode migrar um site de avaliação, de desenvolvedor ou de produção para outro site de avaliação, de desenvolvedor ou de produção no mesmo ambiente ou em um ambiente diferente. Você precisa provisionar um site de produção em um ambiente de área restrita ou de produção.

Provisione um novo site no seu ambiente de destino. Use o mesmo modelo de site que você usou em seu ambiente de origem. Por exemplo, se você provisionou um site usando o modelo de autoatendimento Dynamics 365 cliente em seu ambiente de origem, provisione o site usando o modelo de autoatendimento do Dynamics 365 cliente em seu ambiente de destino.
No ambiente de destino, use o aplicativo Gerenciamento do Portal para excluir o registro do site recém-criado. Essa ação remove os dados de configuração de site padrão do ambiente de destino.
No ambiente de destino, no Power Apps, exclua o aplicativo do portal. Essa ação remove o site atualmente configurado para renderizar o site padrão.

Observação

Não exclua o aplicativo Gerenciamento do Portal!

Transfira a configuração do site no ambiente de destino

Transfira os metadados do site do ambiente de origem usando a CLI do Power Platform, a Ferramenta de Migração de Configuração ou soluções.

Reativar o site no ambiente de destino

Depois de transferir o site para o ambiente de destino, reative o site.

No ambiente de destino, na tela inicial do Power Pages, selecione sites inativos. Você vê o site migrado para o ambiente.
Selecione Reativar.
Insira o nome do site reativado e crie um endereço Web ou aceite os valores padrão.
Escolha Concluído.
As atualizações do site do ambiente de origem aparecem neste novo ambiente de destino. Daqui para frente, você pode transferir a configuração de sua origem para ambientes de destino transferindo os dados de configuração do site.

Observação

Um site que aparece na lista de sites inativos na home page do Power Pages também aparece na lista de Sites Ativos no aplicativo Gerenciamento de Portal.

Transferir metadados do site

Se você configurar seu site usando o modelo de dados aprimorado, poderá transferir a configuração do site usando soluções do Power Platform. Para obter mais informações, consulte Como usar soluções com Power Pages.

Observação

Verifique se o ambiente de destino também tem o modelo de dados aprimorado habilitado.

Transferir a configuração do site usando a CLI do Power Platform

Microsoft Power Platform CLI fornece muitos recursos especificamente para Power Pages. Esses comandos permitem baixar a configuração do site de um ambiente de origem e transferi-la para um ambiente de destino. Você também pode incorporar esses comandos em seus processos de ALM.

Crie perfis de autenticação da CLI do Power Platform para se conectar aos ambientes de origem e destino. Forneça os nomes dos perfis para identificar facilmente os ambientes de destino e de origem.
```
pac auth create --name [name] --url [environment url]
```
Exemplo
```
pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
```
Quando você cria os perfis de autenticação, cada perfil tem um índice associado que você pode determinar usando o comando de lista.
```
pac auth list
```
Selecione o perfil de autenticação da CLI do Power Platform conectado ao ambiente de origem.
```
pac auth select --index [source environment index]
```
Exemplo
```
pac auth select --index 1
```
Determine a identificação do site de origem.

pac pages list
Baixe os dados de configuração do site na sua estação de trabalho local. Use o conjunto de opções --overwrite como true se você tiver baixado a configuração do site anterior no mesmo caminho.

pac pages download --path [path] --webSiteId [website id]

Exemplo

pac pages download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
Selecione o perfil de autenticação da CLI do Power Platform conectado ao ambiente de destino.

pac auth select --index [target environment index]

Exemplo

pac auth select --index 2
Carregue os dados de configuração do site no ambiente de destino.

pac pages upload --path [path]

Exemplo

pac pages upload --path "C:\paportals\portaldev"

Observação

A ferramenta Power Platform CLI não migra tabelas ou esquema de tabela do Dataverse. A migração pode falhar com elementos ausentes, como tabelas e campos, quando os dados de configuração não correspondem ao esquema selecionado.
Durante a importação, verifique se o ambiente de destino contém o mesmo tipo de modelo de site já instalado com quaisquer outras personalizações adicionais, como tabelas, campos, formulários ou exibições, importadas separadamente como soluções.

Transferir a configuração do site usando a ferramenta de Migração de Configuração

Observação

O método preferencial para transferir metadados do site é usar soluções ou a CLI do Power Platform.

Para exportar dados de configuração, use a ferramenta de Migração de Configuração e um arquivo de esquema de configuração específico do site. Para obter mais informações sobre a ferramenta, consulte Gerencie os dados configuração.

Observação

Use a versão mais recente da ferramenta de Migração de Configuração. Você pode baixar a ferramenta de Migração de Configuração do NuGet. Para obter mais informações sobre como baixar a ferramenta, consulte Baixar ferramentas do NuGet.
A versão de solução mínima dos sites com suporte dos arquivos de esquema para migração de configuração é 8.4.0.275. No entanto, use a versão mais recente da solução.
As organizações de origem e de destino devem ter o mesmo idioma padrão para que a migração funcione com êxito.

Os arquivos de esquema estão disponíveis nos tipos de sites a seguir:

Sites criados em um ambiente com o Dataverse
- Portal personalizado (Portal em branco)
- Portal personalizado (portal em branco) (para a versão 9.2.2103.x)
- Portal personalizado (portal em branco) (para a versão 9.3.2201.x ou superior)
Sites criados em um ambiente que contém aplicativos do Customer Engagement (como Dynamics 365 Sales e Dynamics 365 Customer Service)
- Portal personalizado (Portal em branco)
- Portal personalizado (portal em branco) (para a versão 9.2.2103.x)
- Portal personalizado (portal em branco) (para a versão 9.3.2201.x ou superior)
- Portal da comunidade
- Portal de Autoatendimento para Clientes
- Portal do parceiro
- Portal de Autoatendimento para Funcionários

Os arquivos de esquema padrão contêm informações sobre tabelas, relacionamentos e definições de exclusividade do site para cada entidade. Para obter mais informações, consulte Exportar dados de configuração do site.

Depois de exportar os dados de configuração, importe-os para o ambiente de destino. Para obter mais informações, consulte Importar dados de configuração do site.

Observação

A ferramenta de migração de configuração usa o esquema para exportar e importar dados de configuração. A ferramenta não migra tabela ou esquema de tabela do Dataverse. A migração pode falhar com elementos ausentes, como tabelas e campos, quando os dados de configuração não corresponderem ao esquema selecionado.
Durante a exportação, verifique se o ambiente de origem contém tabelas de site, conforme especificado no arquivo de esquema da ferramenta de Migração de Configuração. Você ainda pode alterar os arquivos de esquema para adicionar, remover e modificar tabelas e atributos para migrar o subconjunto de dados de configuração.
Durante a importação, verifique se o ambiente de destino contém o mesmo tipo de site já instalado com quaisquer outras personalizações adicionais, como tabelas, campos, formulários ou exibições importados separadamente como soluções.

Exportar dados de configuração do site

Você pode exportar dados de configuração de um site a partir do sistema de origem usando arquivos de esquema de configuração específicos para o site.

Baixe a ferramenta de Migração de Configuração e extraia-a para a pasta desejada.
Baixe o arquivo de esquema de configuração do site usando os links fornecidos anteriormente para o tipo de modelo de site.
Clique duas vezes no arquivo DataMigrationUtility.exe na <your_folder>\Tools\ConfigurationMigration pasta para executar a ferramenta de Migração de Configuração. Escolha Exportar dados na tela principal e selecione Continuar.
No Logon, insira os detalhes de autenticação para se conectar ao seu ambiente do Dataverse. Se você quiser exportar dados de várias organizações no ambiente do Dataverse, marque a caixa de seleção Exibir lista de organizações disponíveis e selecione Logon.
Se você marcar a caixa de seleção Exibir lista de organizações disponíveis , a próxima tela solicitará que você escolha a organização à qual deseja se conectar. Selecione um ambiente do Dataverse para estabelecer conexão.

Observação

Se você não tiver várias organizações, essa tela não será exibida.
No arquivo de esquema, navegue e selecione o arquivo de esquema de configuração específico do site a ser usado para a exportação de dados.
Em Salvar em arquivo de dados, especifique o nome e a localização do arquivo de dados a ser exportado.
Selecione Exportar dados. As tela exibe o status do progresso da exportação e a localização do arquivo exportado na parte inferior de tela quando a exportação for concluída.
Selecione Sair para fechar a ferramenta.

Importar dados de configuração do site

Execute a ferramenta de Migração de Configuração, selecione Importar dados na tela principal e selecione Continuar.
No Logon, insira os detalhes de autenticação para se conectar ao seu ambiente do Dataverse. Se você quiser exportar dados de várias organizações no ambiente do Dataverse, marque a caixa de seleção Exibir lista de organizações disponíveis e selecione Logon.
Se você marcar a caixa de seleção Exibir lista de organizações disponíveis , a próxima tela solicitará que você escolha a organização à qual deseja se conectar. Selecione um ambiente do Dataverse para estabelecer conexão.
Observação
- Se você não tiver várias organizações, não verá essa tela.
- Verifique se a solução do portal já está instalada para a organização em que você planeja importar as configurações.
A próxima tela solicita que você forneça o arquivo de dados (.zip) para importar. Procure o arquivo de dados, selecione-o e clique Importar Dados.
As próximas telas mostram o status da importação dos seus registros. A importação de dados é executada em várias etapas: primeiro, para importar os dados fundamentais enquanto os dados dependentes são colocados na fila e, em seguida, para importar esses dados dependentes nas etapas subsequentes, a fim de lidar com quaisquer dependências ou vínculos entre os dados. Esta ação garante uma importação de dados limpa e consistente.
Selecione Sair para fechar a ferramenta.

Criar um site usando dados migrados

Se o processo de migração atualizar um site existente, você verá as atualizações no ambiente de destino.

Se a migração for para um novo site, o site migrado aparecerá na guia Sites Inativos na home page Power Pages.

No ambiente de destino, na tela inicial do Power Pages, selecione sites inativos. Você vê o site migrado para o ambiente.
Selecione Reativar.
Insira o nome do site reativado e crie um endereço Web ou aceite os valores padrão.
Escolha Concluído.

Migração de locatário para locatário

Para mover um Power Pages site para outro locatário, exporte o site como parte de uma solução, exclua ou redefina o site no locatário de origem e importe e ative o site no ambiente de locatário de destino.

Importante

Use o artigo Migrações entre locatários do Power Platform para ver os pré-requisitos no nível do ambiente e as etapas de migração.

Planejar a movimentação

Identifique a configuração específica do locatário que você precisa reconfigurar. Conexões de site, registros de aplicativo, provedores de autenticação, integrações e algumas configurações de administrador não são transferidas em um estado pronto para uso.

Mover a configuração do site

Exporte a configuração e as personalizações do site como parte de uma solução. Para transferir dados de configuração adicionais, use as etapas de transferência de metadados do site neste artigo.
Exclua ou redefina o site no locatário de origem antes de mover o ambiente.
Conclua a migração no nível do ambiente seguindo as orientações do Power Platform sobre migrações de locatário para locatário.
Importe a solução de site para o ambiente do locatário de destino.
Ative o site importado da guia Sites Inativos no Power Pages. Para obter as etapas de ativação, consulte Reativar o site no ambiente de destino.
Reconfigure conexões, integrações, recursos de runtime, dados do site e configurações de administrador específicos do locatário.
Converta o site em produção após a conclusão da migração.

Reconfigurar conexões e integrações

Depois de ativar o site no ambiente de locatário de destino, reconfigure manualmente as conexões e as integrações que dependem de recursos específicos do locatário.

Reconfigure as conexões de site porque o registro do aplicativo para as alterações na conexão do host do portal com o Dataverse.
Configure o domínio personalizado e o certificado SSL associado.
Reautenticar a conexão SharePoint.
Reconfigure a autenticação do workspace do Power BI e atualize os IDs do workspace referenciados no código do site.
Confirme se os GUIDs dos fluxos de nuvem do Power Automate são preservados após a migração. Reconfigure as referências de fluxo e as conexões conforme necessário.

Reconfigurar recursos de runtime

Examine e reconfigure recursos de runtime que dependem da identidade do locatário, registros de aplicativo ou conexões de serviço.

Configure os provedores de autenticação, especialmente os provedores que dependem do locatário de origem do Microsoft Entra.
Reconfigure agentes do Microsoft Copilot Studio.
Reconfigurar fluxos de nuvem.
Reconfigure aplicativos externos.

Migrar dados do site

Migre dados do site que não são transferidos com a configuração do site.

Migre os usuários autenticados do site, incluindo registros de contato do Dataverse e registros de dados específicos do site.
Migre outros dados do site necessários para a experiência do site de destino.

Reconfigurar configurações de administrador

Algumas configurações de administrador retornam aos seus valores padrão após a migração. Examine e defina essas configurações no ambiente de locatário de destino.

Configure os recursos de IA para o site de destino.
Reconfigure outros recursos que revertem para valores padrão, como configurações de SharePoint, Power BI e governança.
Reconfigure as configurações da CDN (rede de distribuição de conteúdo) e do WAF (firewall do aplicativo Web).

Observação

Antes de entrar em atividade, valide todas as páginas, permissões, acesso do usuário e integrações no ambiente do locatário de destino.

Confira também

Suporte do Power Pages para Microsoft Power Platform CLI
Usar soluções com o Power Pages
Modelo de dados aprimorado
Migração de locatário para locatário de um ambiente do Power Platform
Migração de locatário para locatário de aplicativos baseados em modelo no Dynamics 365, como Sales, Customer Service, Marketing, Field Service e Project Service Automation

Comentários

Esta página foi útil?

Last updated on 2026-07-21

Migrar configuração do site

Preparar o ambiente de destino

Transfira a configuração do site no ambiente de destino

Reativar o site no ambiente de destino

Transferir metadados do site

Criar um site usando dados migrados

Migração de locatário para locatário

Planejar a movimentação

Mover a configuração do site

Reconfigurar conexões e integrações

Reconfigurar recursos de runtime

Migrar dados do site

Reconfigurar configurações de administrador

Confira também

Comentários

Recursos adicionais