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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powerembedded.com.br/portal-de-administracao/migracao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.