> 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 do Microsoft Entra ID necessários para as aplicações RealmJoin * Atribui as permissões apropriadas do Microsoft Graph com base nos recursos que selecionar * Configura os recursos do RealmJoin (Portal, Intune LAPS, Autopilot, ações do dispositivo, scripts de remediação, recursos de segurança) * Remove aplicações legadas de configurações anteriores O módulo é publicado na [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin). ## Pré-requisitos {% hint style="info" %} Os módulos necessários do Azure PowerShell (`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 possa **criar Service Principals e conceder permissões de aplicação** em 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 **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 {% hint style="info" %} Desde a versão 2.0, o módulo inicia sessão com a **Azure PowerShell** aplicação e os `Az` módulos. As versões anteriores usavam a aplicação Microsoft Graph PowerShell em vez disso — se o seu tenant tiver dado consentimento apenas a essa aplicação, será necessário conceder consentimento à aplicação Azure PowerShell uma vez. {% endhint %} ## Configuração recomendada O comando de configuração apresentado pelo RealmJoin Portal concederá permissões para: * Recursos principais * Intune LAPS * Dados de início de sessão * Scripts de remediação * Autopilot * Ações de dispositivo do Intune Para adicionar todos os recursos ou recursos 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 **sessão recém-aberta** sessão do PowerShell no seu próprio dispositivo em vez de no Azure Cloud Shell. O módulo requer versões exatas dos `Az.*` módulos; se já estiver carregada na sessão uma versão diferente — o que normalmente acontece no Cloud Shell — a execução é interrompida 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 integração do RealmJoin O script pedirá que inicie sessão em Azure. Use uma conta que possa criar Service Principals e conceder permissões de aplicação, por exemplo o seu Administrador Global. ```powershell Install-Module -Force -Name RealmJoin Complete-RJTenantOnboarding -Token 1234ABCD 6>&1 ``` {% hint style="info" %} **Sobre `6>&1`:** Estes comandos escrevem as suas atualizações de progresso no Information stream do PowerShell. A `6>&1` redireção apresenta esse resultado na consola — sem ela, não verá as mensagens detalhadas de progresso durante a execução. {% endhint %}
{% endstep %} {% step %} #### Começar a utilizar o RealmJoin Quando terminar, o script iniciará o RealmJoin Portal
{% hint style="info" %} **Terminar sessão depois:** o início de sessão em Azure permanece ativo depois de o comando terminar. Quando concluir, execute `Disconnect-AzAccount` para terminar a sessão existente. {% endhint %} {% endstep %} {% endstepper %} ## Outros comandos ### Configuração interativa Para uma experiência guiada, baseada em menus, 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 os recursos disponíveis antes de configurar qualquer coisa: ```powershell Show-RJFeatureInfo ``` ### Configuração personalizada #### Recursos predefinidos Ativa a funcionalidade principal obrigatória do portal, mais os recursos opcionais predefinidos (tudo exceto o RealmJoin Client): ```powershell New-RJTenant 6>&1 ``` #### Recursos mínimos (apenas recursos obrigatórios) ```powershell New-RJTenant -Features @('RealmJoinPortal') 6>&1 ``` #### Conjunto completo de recursos ```powershell New-RJTenant -All 6>&1 ``` #### Permissões só de leitura Atribui permissões só de leitura sempre que disponíveis (por exemplo, `Group.ReadWrite.All` torna-se `Group.Read.All`): ```powershell New-RJTenant -ReadOnly 6>&1 ``` #### Seleção personalizada de recursos ```powershell New-RJTenant -Features @('RealmJoinPortal', 'IntuneLAPS', 'Autopilot') 6>&1 ``` ### Atualizar configuração existente `Update-RJTenant` ajusta um tenant já configurado. O alias `Complete-RJTenantOnboarding` pode ser usado de forma intercambiável com `Update-RJTenant`. #### Adicionar novos recursos ```powershell Update-RJTenant -AddFeatures @('SecurityFeatures') 6>&1 ``` #### Remover recursos ```powershell Update-RJTenant -RemoveFeatures @('ShowSignin') 6>&1 ``` #### Mudar para permissões só de leitura ```powershell Update-RJTenant -ReadOnly 6>&1 ``` #### Pré-visualizar alterações ```powershell Update-RJTenant -AddFeatures @('SecurityFeatures') -WhatIf 6>&1 ``` ### Recursos do Azure O módulo também implementa os recursos do Azure complementares que o RealmJoin utiliza. Estes não são recursos 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 Data Collection Rules, consulte [Ligação ao Azure Log Analytics Workspace](/pt/monitorizacao-e-registos/log-analytics.md) * `Set-RJAutomationAccount` — implementa a RealmJoin Automation Account com uma identidade gerida e as permissões de que necessita, consulte [Ligação ao Azure Automation](/pt/automatizacao/connecting-azure-automation.md) Ambos os comandos são gerados com os parâmetros correspondentes e um token de integração na página de definições relevante no RealmJoin Portal. ## Recursos disponíveis Use estes nomes de recursos com os `-Features`, `-AddFeatures`, e `-RemoveFeatures` parâmetros. Os recursos obrigatórios estão sempre ativados. A configuração predefinida (`New-RJTenant` sem parâmetros) ativa os recursos marcados abaixo; **SecurityFeatures** e **Client** têm de ser selecionados explicitamente. | Recurso | Descrição | Predefinição | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------- | :----------: | | `RealmJoinPortal` | Funcionalidade principal do portal para autoatendimento do utilizador e interação do administrador (obrigatória) | ☑️ | | `IntuneLAPS` | Obter e gerir palavras-passe de administrador local via Intune LAPS | ☑️ | | `ShowSignin` | Apresentar o histórico de início de sessão do utilizador e os registos de auditoria | ☑️ | | `Autopilot` | Ver perfis de implementação e o estado 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 no Windows Device Updates | ☑️ | | `SecurityFeatures` | Proteção avançada contra ameaças e análises de segurança (requer licenças MDE) | | | `Client` | RealmJoin Agent — aplicação cliente para gestão de dispositivos | | ## Resoluçã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*. Consulte [Pré-requisitos](#prerequisites). {% endhint %} {% hint style="warning" %} **"É necessária aprovação do administrador" ou um erro de consentimento durante o início de sessão** — o início de sessão usa a **Azure PowerShell** aplicação de primeira parte. Se o seu tenant restringir o consentimento do utilizador, um administrador tem de conceder o consentimento de administrador a essa aplicação uma vez. {% 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, depois feche a sessão e abra uma nova: ```powershell Install-Module -Name RealmJoin -Force -Scope CurrentUser ``` {% endhint %} {% hint style="warning" %} **É reportado um conflito de versões do 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 o 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=&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.