> For the complete documentation index, see [llms.txt](https://docs.powerembedded.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerembedded.com.br/portal-de-administracao/migracao.md).

# Migração

Para simplificar a configuração do Power Embedded, preparamos um script que automatiza o processo de importação de usuários, RLS e relatórios do Power BI para o Power Embedded de forma simples e fácil.

## Requisitos

Para conseguir executar o processo de migração é importante está com as seguintes permissões habilitadas:

<details>

<summary>Permissão de admin do usuário de serviço</summary>

Essa permissão precisa está habilitada em todos os workspaces que irão está disponível no portal.

Para adicionar o Service Principal criado como administrador de um workspace, acesse o workspace, clique nos 3 pontinhos e selecione a opção “Gerenciar acesso

<img src="/files/2oAeWJciAMQ90D62clvb" alt="" data-size="original">

Clique no botão “+ Adicionar pessoas ou grupos”

<img src="/files/tViOc7h7WKIylLatnQTU" alt="" data-size="original">

Pesquise pelo nome do aplicativo que foi criado anteriormente (PowerEmbedded-App) e lembre de alterar o nível de acesso para “Administrador”. Após isso, clique no botão “Add”

<img src="/files/fp41CWs7drSkcE5ahyFR" alt="" data-size="original">

Pronto! Agora o Power Embedded já possui acesso nesse workspace. Repita isso para todos os Workspaces que você quer importar relatórios.

</details>

<details>

<summary>Permissões Leitura API</summary>

Permissões para a importação de dados do Entra ID

Para ser possível importar dados de usuários e grupos do Entra ID, é necessário atribuir algumas permissões para o Service Principal, criado no Portal do Azure, utilizado pelo Power Embedded para se comunicar com o seu ambiente.

Na tela de [Registro de aplicativos](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps), pesquise pelo nome do aplicativo criado (O nome padrão é PowerEmbedded-App).

Na tela do aplicativo, clique em *API permissions*, no menu lateral e depois em *Add a Permission*.

<img src="/files/Gcm7o8gJmBGme5buGsf9" alt="" data-size="original">

Na próxima tela selecione a opção do *Microsoft Graph*.

<img src="/files/6vI9I73RSuS5nBZO9S8G" alt="" data-size="original">

Em seguida selecione a opção de *Application permissions*.

<img src="/files/HLb1U2seS6Mo5OPw428E" alt="" data-size="original">

Na aba a seguir, busque por *Directory* e selecione a primeira opção *Directory.Read.All* e clique em *Add permissions*.

<img src="/files/pREydml3R4lt2yuzPks4" alt="" data-size="original">

Para finalizar basta conceder o consentimento do administrador clicando em *Grant admin consent for*.

<img src="/files/JWU9w7R5zAJNMB8cKOBd" alt="" data-size="original">

Pronto, agora você já conseguirá importar os usuários e grupos do Azure AD (Entra ID) para o Power Embedded.

</details>

## Instruções

Com as devidas permissões habilitadas agora é só seguir o passo a passo de processo.

Vá ao portal de administração do Power Embedded no menu de migração, siga estas etapas. Nesse menu siga as instruções abaixo.

**Etapa 1:** Gere os tokens de acesso utilizando o botão abaixo e copie. O token gerado será válido por apenas 1 hora.

<figure><img src="/files/SU3l8fBKHjDAAblhWtOv" alt=""><figcaption></figcaption></figure>

**Etapa 2:** Abra o script PowerShell disponível no link dessa página, copie e cole no console do PowerShell.

**Etapa 3**: Substitua as variáveis do script pelos respectivos valores

<figure><img src="/files/z3LoNSY8LpYNwMX7zseJ" alt=""><figcaption></figcaption></figure>

**ID de Cliente do Power BI**: Acesse o Portal de Administração do Power BI Embedded > Configurações > campo “ID de Cliente do Power BI”.

<figure><img src="/files/z0zJNiJ5a3yTqPBKF71D" alt=""><figcaption></figcaption></figure>

**Chave de API**: Acesse o Portal de Administração do Power BI Embedded > Configurações > campo “Chave de API” (clique no ícone em vermelho para gerar a chave).

<figure><img src="/files/c4yI87QMILMfqDPojMuV" alt=""><figcaption></figcaption></figure>

**Pbi Token:** Chave Gerada no menu de migração

<figure><img src="/files/oHl7DJQHtmBSkN4IxhXt" alt=""><figcaption></figcaption></figure>

**Ad Token :** Chave gerada no menu de migração.

<figure><img src="/files/zbDmBKhdH0SKocwkkD6E" alt=""><figcaption></figcaption></figure>

Com os campos preenchidos agora é só rodar o código no Power Shell.

<figure><img src="/files/QfjoPmWqhGYXTIdItu7M" alt=""><figcaption></figcaption></figure>

Com o script finalizado, todos os relatórios, usuários, e rls estarão importados no Power Embedded.