> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/implementacao/onboarding-realmjoin-portal/advanced-setup.md).

# Configuração avançada

A Configuração avançada permite-lhe atribuir permissões de uma forma mais granular e personalizada. Esta abordagem é mais flexível, mas mais complexa e requer a execução do módulo RealmJoin PowerShell.

O módulo PowerShell do RealmJoin automatiza a configuração do seu tenant RealmJoin. Ele:

* Cria os service principals necessários do Microsoft Entra ID para as aplicações RealmJoin
* Atribui as permissões adequadas do Microsoft Graph com base nas funcionalidades que selecionar
* Configura as funcionalidades do RealmJoin (Portal, Intune LAPS, Autopilot, ações do dispositivo, scripts de remediação, funcionalidades de segurança)
* Remove aplicações legadas de configurações anteriores

O módulo é publicado em [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin).

## Pré-requisitos

{% hint style="info" %}
Os módulos Azure PowerShell necessários (`Az.Accounts`, `Az.Resources`, `Az.Automation`) são instalados automaticamente, nas versões fixadas pelo módulo, para o utilizador atual, na primeira vez que executar um comando.
{% endhint %}

* **PowerShell 5.1** ou posterior (Windows PowerShell ou PowerShell 7)
* Uma conta que pode **criar service principals e conceder permissões de aplicação** no Microsoft Entra ID — por exemplo *Administrador Global* ou *Administrador de Funções Privilegiadas*
* O início de sessão ocorre através de `Connect-AzAccount`, que usa a aplicação **Azure PowerShell** aplicação de primeira parte. Os tenants que restringem o consentimento do utilizador podem precisar que um administrador conceda primeiro o consentimento de administrador a essa aplicação.
* Acesso à [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) para instalar o módulo

Uma subscrição Azure só é necessária para os recursos Azure (`Set-RJLogAnalyticsWorkspace`, `Set-RJAutomationAccount`). `New-RJTenant` e `Update-RJTenant` trabalhar num tenant sem qualquer subscrição; inicie sessão nele com `Connect-AzAccount -Tenant <tenant-id>` primeiro.

## Configuração Recomendada

O comando de configuração apresentado pelo RealmJoin Portal executa `Complete-RJTenantOnboarding` (alias de `Update-RJTenant`) sem seleção de funcionalidades. Atribui as permissões da funcionalidade obrigatória e de todas as funcionalidades predefinidas:

* Funcionalidade principal do portal (`RealmJoinPortal`, obrigatória)
* Intune LAPS (`IntuneLAPS`)
* Dados de início de sessão (`ShowSignin`)
* Autopilot (`Autopilot`)
* Ações do dispositivo Intune (`DeviceIntuneActions`)
* Scripts de remediação (`DeviceHealthScript`)
* Chaves de recuperação do BitLocker (`BitLockerRecoveryKeys`)
* Inscrição em atualizações de dispositivos Windows (`WindowsDeviceUpdateEnrollment`)

Funcionalidades já configuradas no tenant, por exemplo `SecurityFeatures` ou `Cliente`, são mantidas. Para adicionar todas as funcionalidades ou funcionalidades individuais, consulte [Outros comandos](#other-commands).

{% stepper %}
{% step %}

#### Abra o PowerShell no Windows/Mac

Recomendamos instalar e executar o módulo PowerShell do RealmJoin numa **recém-aberta** sessão do PowerShell no seu próprio dispositivo, em vez de no Azure Cloud Shell. O módulo requer uma linha de versão secundária fixa de cada `Az.*` módulo (`Az.Accounts` 5.5.x, `Az.Resources` 10.2.x, `Az.Automation` 1.12.x); se uma versão diferente já estiver carregada na sessão — o que normalmente acontece no Cloud Shell — pára com um conflito de versões que não pode ser resolvido sem abrir uma nova sessão.

Não é necessária uma sessão elevada ("Executar como administrador"): os módulos são instalados com `-Scope CurrentUser`.
{% endstep %}

{% step %}

#### Copiar e Executar o Script de Onboarding do RealmJoin

O script irá solicitar que inicie sessão no Azure. Use uma conta que possa criar service principals e conceder permissões de aplicação, por exemplo o seu Administrador Global.

O token no comando associa a execução ao seu tenant no RealmJoin Portal. É válido por uma hora; se tiver expirado, abra novamente a página de Configuração Avançada no portal para obter um comando com um novo token.

```powershell
Install-Module -Force -Name RealmJoin
Complete-RJTenantOnboarding -Token 1234ABCD 6>&1
```

{% hint style="info" %}
**Sobre `6>&1`:** Estes comandos escrevem as atualizações de progresso no fluxo Information do PowerShell. O `6>&1` redirecionamento mostra esse output na consola — sem ele, não verá as mensagens detalhadas de progresso durante a execução.
{% endhint %}

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FdxYM2mTZ5LNcJhgudknf%2FSnipaste_2026-01-27_12-00-54.png?alt=media&amp;token=1fa4cd4e-485a-43e4-8a90-f6e6f6f57cb5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Comece a usar o RealmJoin

Depois de as permissões terem sido atribuídas, o comando envia o token para a API do RealmJoin. A página de Configuração Avançada no portal verifica periodicamente se o token foi utilizado e, em seguida, redireciona-o para o portal. Mantenha a página aberta enquanto o comando é executado.

Se o service principal do RealmJoin Portal ainda não existia no tenant, o comando também abre o RealmJoin Portal no seu navegador.

{% hint style="info" %}
**Terminar sessão depois:** o início de sessão do Azure mantém-se ativo depois de o comando terminar. Quando acabar, execute `Disconnect-AzAccount` para terminar sessão da sessão existente.
{% endhint %}
{% endstep %}
{% endstepper %}

## Outros comandos

### Configuração Interativa

Para uma experiência guiada e orientada por menu que abrange a configuração do tenant, alterações de configuração, o Log Analytics Workspace e a Automation Account:

```powershell
Show-RJInteractiveSetup
```

Para rever as funcionalidades disponíveis antes de configurar qualquer coisa:

```powershell
Show-RJFeatureInfo
```

### Configuração Personalizada

`New-RJTenant` configura um tenant com exatamente as funcionalidades selecionadas. Use-o para tenants que ainda não estão configurados.

{% hint style="warning" %}
Num tenant que já está configurado, `New-RJTenant` remove as permissões de todas as funcionalidades configuradas que não façam parte da seleção e elimina os service principals que ficam sem permissões. Por exemplo, `New-RJTenant` sem parâmetros remove `SecurityFeatures` e `Cliente`. Para alterar uma configuração existente, use [`Update-RJTenant`](#updating-existing-configuration).
{% endhint %}

#### Funcionalidades Predefinidas

Ativa a funcionalidade principal obrigatória do portal, mais as funcionalidades opcionais predefinidas (todas exceto `Cliente`, `SecurityFeatures` e `AndroidApps`):

```powershell
New-RJTenant 6>&1
```

#### Funcionalidades Mínimas (apenas funcionalidades obrigatórias)

```powershell
New-RJTenant -Features @('RealmJoinPortal') 6>&1
```

#### Conjunto Completo de Funcionalidades

```powershell
New-RJTenant -All 6>&1
```

#### Permissões Só de Leitura

Atribui permissões só de leitura quando disponíveis (por exemplo, `Group.ReadWrite.All` torna-se `Group.Read.All`):

```powershell
New-RJTenant -ReadOnly 6>&1
```

Três funcionalidades não têm variante só de leitura e mantêm as suas permissões com `-ReadOnly`:

| Funcionalidade                  | Permissão                                                 |
| ------------------------------- | --------------------------------------------------------- |
| `DeviceIntuneActions`           | `DeviceManagementManagedDevices.PrivilegedOperations.All` |
| `WindowsDeviceUpdateEnrollment` | `WindowsUpdates.ReadWrite.All`                            |
| `AndroidApps`                   | `DeviceManagementConfiguration.ReadWrite.All`             |

Para uma configuração sem permissões de escrita, deixe estas funcionalidades de fora:

```powershell
New-RJTenant -Features @('IntuneLAPS', 'ShowSignin', 'Autopilot', 'DeviceHealthScript', 'BitLockerRecoveryKeys') -ReadOnly 6>&1
```

#### Seleção Personalizada de Funcionalidades

```powershell
New-RJTenant -Features @('RealmJoinPortal', 'IntuneLAPS', 'Autopilot') 6>&1
```

### Atualização de Configuração Existente

`Update-RJTenant` ajusta um tenant já configurado. O alias `Complete-RJTenantOnboarding` pode ser usado de forma intercambiável com `Update-RJTenant`.

* Sem `-Features`, `-All`, `-AddFeatures` ou `-RemoveFeatures`, as funcionalidades já configuradas no tenant são mantidas e as funcionalidades predefinidas são adicionadas. Nada é removido.
* `-Features` substitui a configuração: as funcionalidades configuradas que não estão na lista são removidas, incluindo o respetivo service principal. Uma lista vazia é rejeitada.
* `-AddFeatures` e `-RemoveFeatures` altera apenas as funcionalidades nomeadas.
* Cada execução também remove aplicações legadas do RealmJoin do tenant, consulte [Mudar da Configuração Rápida](#switching-from-quick-setup).

#### Adicionar Novas Funcionalidades

```powershell
Update-RJTenant -AddFeatures @('SecurityFeatures') 6>&1
```

#### Remover Funcionalidades

```powershell
Update-RJTenant -RemoveFeatures @('ShowSignin') 6>&1
```

#### Mudar para Permissões Só de Leitura

Altera as funcionalidades configuradas e as funcionalidades predefinidas para as respetivas permissões só de leitura. As funcionalidades listadas em [Permissões Só de Leitura](#read-only-permissions) mantêm as suas permissões de escrita.

```powershell
Update-RJTenant -ReadOnly 6>&1
```

Combinado com `-AddFeatures`, `-ReadOnly` aplica-se apenas às funcionalidades adicionadas; as permissões das funcionalidades já configuradas permanecem inalteradas.

#### Pré-visualizar Alterações

```powershell
Update-RJTenant -AddFeatures @('SecurityFeatures') -WhatIf 6>&1
```

### Recursos Azure

O módulo também implementa os recursos Azure complementares que o RealmJoin utiliza. Estes não são funcionalidades de permissões do Graph e não são selecionados com `-Features`:

* `Set-RJLogAnalyticsWorkspace` — implementa o Log Analytics Workspace com as suas tabelas personalizadas e Regras de Recolha de Dados, consulte [Ligação ao Azure Log Analytics Workspace](https://docs.realmjoin.com/pt/monitorizacao-e-registos/log-analytics.md)
* `Set-RJAutomationAccount` — implementa a Automation Account do RealmJoin com uma identidade gerida e as permissões de que necessita, consulte [Ligação ao Azure Automation](https://docs.realmjoin.com/pt/automatizacao/connecting-azure-automation.md)

Ambos os comandos são gerados com os parâmetros correspondentes e um token de onboarding na página de definições relevante no RealmJoin Portal.

## Funcionalidades Disponíveis

Use estes nomes de funcionalidades com os `-Features`, `-AddFeatures`, e `-RemoveFeatures` parâmetros. As funcionalidades obrigatórias estão sempre ativadas. A configuração predefinida (`New-RJTenant` sem parâmetros) ativa as funcionalidades assinaladas abaixo; **SecurityFeatures**, **Cliente** e **AndroidApps** têm de ser selecionadas explicitamente.

| Funcionalidade                  | Descrição                                                                                                                                                                                                             | Padrão |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----: |
| `RealmJoinPortal`               | Funcionalidade principal do portal para self-service do utilizador e interação do administrador (obrigatória)                                                                                                         |   ☑️   |
| `IntuneLAPS`                    | Obter e gerir palavras-passe de administrador local via Intune LAPS                                                                                                                                                   |   ☑️   |
| `ShowSignin`                    | Mostrar o histórico de início de sessão do utilizador e os registos de auditoria                                                                                                                                      |   ☑️   |
| `Autopilot`                     | Ver os perfis e o estado de implementação do Windows Autopilot                                                                                                                                                        |   ☑️   |
| `DeviceIntuneActions`           | Executar ações privilegiadas no dispositivo (sincronizar, reiniciar, limpar, etc.)                                                                                                                                    |   ☑️   |
| `DeviceHealthScript`            | Gerir e implementar scripts de remediação do PowerShell em dispositivos                                                                                                                                               |   ☑️   |
| `BitLockerRecoveryKeys`         | Ver as chaves de recuperação do BitLocker para dispositivos geridos                                                                                                                                                   |   ☑️   |
| `WindowsDeviceUpdateEnrollment` | Gerir a inscrição em Windows Device Updates                                                                                                                                                                           |   ☑️   |
| `SecurityFeatures`              | [Integração com Defender for Endpoint](https://docs.realmjoin.com/pt/ugd-management/defender-integration.md) nas páginas do dispositivo (requer licenças MDE)                                                         |        |
| `Cliente`                       | RealmJoin Agent — aplicação cliente para gestão de dispositivos                                                                                                                                                       |        |
| `AndroidApps`                   | [Implementação de aplicações Android](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/android-apps-managed-google-play.md) através do Managed Google Play (`DeviceManagementConfiguration.ReadWrite.All`) |        |

## Mudar da Configuração Rápida

Um tenant configurado com a Configuração Rápida utiliza a **RealmJoin Portal - Core Features** registo de aplicação, que contém todas as permissões do portal. Para o mover para a Configuração Avançada, vá para **Organização → Funcionalidades** no RealmJoin Portal e selecione **Ir para o modo avançado** no **configuração avançada** cartão. O portal apresenta então o comando de onboarding com um token, conforme descrito em [Configuração Recomendada](#recommended-setup).

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-90feb65a312dda59e5e23473be499c34566c8b1c%2Forganization-features-advanced-setup-switch.png?alt=media" alt="Advanced setup card on the Organization Features page"><figcaption><p>cartão de configuração avançada para tenants na Configuração Rápida</p></figcaption></figure>

Quando o comando é executado, o módulo cria os service principals para as funcionalidades selecionadas e remove o **RealmJoin Portal - Core Features** registo de aplicação como uma aplicação legada. Assim que as novas permissões estiverem em vigor, o portal muda o tenant para a Configuração Avançada.

{% hint style="warning" %}
A mudança é unidirecional. Depois de o registo de aplicação Core Features ter sido removido, as permissões são geridas apenas com o módulo PowerShell do RealmJoin.
{% endhint %}

## Solução de problemas

{% hint style="warning" %}
**"Privilégios insuficientes"** — criar service principals e conceder permissões de aplicação requer uma conta com privilégios adequados, por exemplo *Administrador Global* ou *Administrador de Funções Privilegiadas*. Veja [Pré-requisitos](#prerequisites).
{% endhint %}

{% hint style="warning" %}
**"É necessária aprovação de administrador" ou um erro de consentimento durante o início de sessão** — o início de sessão utiliza **Azure PowerShell** aplicação de primeira parte. Se o seu tenant restringir o consentimento do utilizador, um administrador tem de conceder uma vez o consentimento de administrador a essa aplicação.
{% endhint %}

{% hint style="warning" %}
**"O módulo RealmJoin está desatualizado - a execução não pode prosseguir"** — cada comando verifica uma vez por sessão se está a executar a versão publicada mais recente. Instale a versão atual, feche a sessão e abra uma nova:

```powershell
Install-Module -Name RealmJoin -Force -Scope CurrentUser
```

{% endhint %}

{% hint style="warning" %}
**"Falha na autenticação (401). O token pode ser inválido ou ter expirado."** — as permissões foram atribuídas, mas o tenant não pôde ser registado com o RealmJoin porque o token de onboarding expirou (após uma hora) ou é inválido. Abra novamente a página de Configuração Avançada no RealmJoin Portal e execute o comando com o novo token. Executá-lo novamente não altera as permissões que já estão em vigor.
{% endhint %}

{% hint style="warning" %}
**É reportado um conflito de versões de módulo** — um `Az.*` módulo numa versão diferente daquela que o módulo fixa já está carregado. Isto não pode ser corrigido na sessão em execução: feche o PowerShell, abra uma nova sessão e execute o comando novamente.
{% endhint %}

Se o módulo não puder ser encontrado, confirme que a PowerShell Gallery está disponível e reinstale:

```powershell
Get-PSRepository
Install-Module -Name RealmJoin -Force -Scope CurrentUser
```

### Obter Ajuda

```powershell
Get-Help New-RJTenant -Full
Get-Help Update-RJTenant -Examples
Get-Help Show-RJInteractiveSetup -Detailed
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/pt/implementacao/onboarding-realmjoin-portal/advanced-setup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
