> 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/fr/deploiement/onboarding-realmjoin-portal/advanced-setup.md). # Configuration avancée La configuration avancée vous permet d’attribuer des autorisations de manière plus granulaire et personnalisée. Cette approche est plus flexible mais plus complexe et nécessite l’exécution du module PowerShell RealmJoin. Le module PowerShell RealmJoin automatise la configuration de votre Tenant RealmJoin. Il : * Crée les Service Principals Microsoft Entra ID requis pour les applications RealmJoin * Attribue les autorisations Microsoft Graph appropriées en fonction des fonctionnalités que vous sélectionnez * Configure les fonctionnalités RealmJoin (Portal, Intune LAPS, Autopilot, actions sur les appareils, scripts de remédiation, fonctionnalités de sécurité) * Nettoie les applications héritées des configurations précédentes Le module est publié sur le [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin). ## Prérequis {% hint style="info" %} Les modules Azure PowerShell requis (`Az.Accounts`, `Az.Resources`, `Az.Automation`) sont installés automatiquement, dans les versions verrouillées par le module, pour l’utilisateur actuel, la première fois que vous exécutez une commande. {% endhint %} * **PowerShell 5.1** ou version ultérieure (Windows PowerShell ou PowerShell 7) * Un compte capable de **créer des Service Principals et d’accorder des autorisations d’application** dans Microsoft Entra ID — par exemple *Global Administrator* ou *Privileged Role Administrator* * La connexion se fait via `Connect-AzAccount`, qui utilise l’ **Azure PowerShell** application de première partie. Les Tenants qui restreignent le consentement des utilisateurs peuvent avoir besoin qu’un administrateur accorde d’abord le consentement administrateur à cette application. * Accès à la [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) pour installer le module {% hint style="info" %} Depuis la version 2.0, le module se connecte avec le **Azure PowerShell** application et les `Az` modules. Les versions antérieures utilisaient à la place l’application Microsoft Graph PowerShell — si votre Tenant n’a donné son consentement qu’à celle-ci, il faut une fois accorder le consentement à l’application Azure PowerShell. {% endhint %} ## Configuration recommandée La commande de configuration affichée par le RealmJoin Portal fournira des autorisations pour : * Fonctionnalités principales * Intune LAPS * Données de connexion * Scripts de remédiation * Autopilot * Actions sur les appareils Intune Pour ajouter toutes les fonctionnalités ou des fonctionnalités individuelles, voir [Autres commandes](#other-commands). {% stepper %} {% step %} #### Ouvrez PowerShell sur Windows/Mac Nous recommandons d’installer et d’exécuter le module PowerShell RealmJoin dans une **tout juste ouverte** session PowerShell sur votre propre appareil plutôt que dans Azure Cloud Shell. Le module nécessite des versions exactes des `Az.*` modules ; si une version différente est déjà chargée dans la session — ce qui est généralement le cas dans Cloud Shell — il s’arrête avec un conflit de versions qui ne peut pas être résolu sans ouvrir une nouvelle session. Une session élevée ("Exécuter en tant qu’administrateur") n’est pas requise : les modules sont installés avec `-Scope CurrentUser`. {% endstep %} {% step %} #### Copier et exécuter le script d’intégration RealmJoin Le script vous invitera à vous connecter à Azure. Utilisez un compte capable de créer des Service Principals et d’accorder des autorisations d’application, par exemple votre administrateur général. ```powershell Install-Module -Force -Name RealmJoin Complete-RJTenantOnboarding -Token 1234ABCD 6>&1 ``` {% hint style="info" %} **À propos `6>&1`:** Ces commandes écrivent leurs mises à jour de progression dans le flux Information de PowerShell. La `6>&1` redirection affiche cette sortie dans la console — sans elle, vous ne verrez pas les messages détaillés de progression pendant l’exécution. {% endhint %}
{% endstep %} {% step %} #### Commencez à utiliser RealmJoin Une fois terminé, le script lancera le RealmJoin Portal
{% hint style="info" %} **Se déconnecter ensuite :** la connexion Azure reste active une fois la commande terminée. Une fois que vous avez terminé, exécutez `Disconnect-AzAccount` pour vous déconnecter de la session existante. {% endhint %} {% endstep %} {% endstepper %} ## Autres commandes ### Configuration interactive Pour une expérience guidée, pilotée par menu, couvrant la configuration du Tenant, les modifications de configuration, le Log Analytics Workspace et le Automation Account : ```powershell Show-RJInteractiveSetup ``` Pour consulter les fonctionnalités disponibles avant de configurer quoi que ce soit : ```powershell Show-RJFeatureInfo ``` ### Configuration personnalisée #### Fonctionnalités par défaut Active la fonctionnalité de portail principale obligatoire ainsi que les fonctionnalités facultatives par défaut (tout sauf le RealmJoin Client) : ```powershell New-RJTenant 6>&1 ``` #### Fonctionnalités minimales (uniquement les fonctionnalités obligatoires) ```powershell New-RJTenant -Features @('RealmJoinPortal') 6>&1 ``` #### Ensemble complet de fonctionnalités ```powershell New-RJTenant -All 6>&1 ``` #### Autorisations en lecture seule Attribue des autorisations en lecture seule lorsque c’est possible (par exemple, `Group.ReadWrite.All` devient `Group.Read.All`): ```powershell New-RJTenant -ReadOnly 6>&1 ``` #### Sélection personnalisée des fonctionnalités ```powershell New-RJTenant -Features @('RealmJoinPortal', 'IntuneLAPS', 'Autopilot') 6>&1 ``` ### Mise à jour d’une configuration existante `Update-RJTenant` ajuste un Tenant déjà configuré. L’alias `Complete-RJTenantOnboarding` peut être utilisé de manière interchangeable avec `Update-RJTenant`. #### Ajouter de nouvelles fonctionnalités ```powershell Update-RJTenant -AddFeatures @('SecurityFeatures') 6>&1 ``` #### Supprimer des fonctionnalités ```powershell Update-RJTenant -RemoveFeatures @('ShowSignin') 6>&1 ``` #### Passer aux autorisations en lecture seule ```powershell Update-RJTenant -ReadOnly 6>&1 ``` #### Prévisualiser les modifications ```powershell Update-RJTenant -AddFeatures @('SecurityFeatures') -WhatIf 6>&1 ``` ### Ressources Azure Le module déploie également les ressources Azure associées que RealmJoin utilise. Il ne s’agit pas de fonctionnalités d’autorisation Graph et elles ne sont pas sélectionnées avec `-Features`: * `Set-RJLogAnalyticsWorkspace` — déploie le Log Analytics Workspace avec ses tables personnalisées et ses Data Collection Rules, voir [Connexion à Azure Log Analytics Workspace](/fr/supervision-et-journaux/log-analytics.md) * `Set-RJAutomationAccount` — déploie le RealmJoin Automation Account avec une identité managée et les autorisations dont il a besoin, voir [Connexion à Azure Automation](/fr/automatisation/connecting-azure-automation.md) Les deux commandes sont générées avec les paramètres correspondants et un jeton d’intégration sur la page de paramètres appropriée dans le RealmJoin Portal. ## Fonctionnalités disponibles Utilisez ces noms de fonctionnalité avec les `-Features`, `-AddFeatures`, et `-RemoveFeatures` paramètres. Les fonctionnalités obligatoires sont toujours activées. La configuration par défaut (`New-RJTenant` sans paramètres) active les fonctionnalités indiquées ci-dessous ; **SecurityFeatures** et **Client** doivent être sélectionnées explicitement. | Feature | Description | Défaut | | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | :----: | | `RealmJoinPortal` | Fonctionnalité principale du portail pour l’auto-service des utilisateurs et l’interaction administrateur (obligatoire) | ☑️ | | `IntuneLAPS` | Récupérer et gérer les mots de passe administrateur locaux via Intune LAPS | ☑️ | | `ShowSignin` | Afficher l’historique de connexion des utilisateurs et les journaux d’audit | ☑️ | | `Autopilot` | Afficher les profils de déploiement Windows Autopilot et leur état | ☑️ | | `DeviceIntuneActions` | Exécuter des actions privilégiées sur les appareils (synchronisation, redémarrage, effacement, etc.) | ☑️ | | `DeviceHealthScript` | Gérer et déployer des scripts de remédiation PowerShell sur les appareils | ☑️ | | `BitLockerRecoveryKeys` | Afficher les clés de récupération BitLocker pour les appareils gérés | ☑️ | | `WindowsDeviceUpdateEnrollment` | Gérer l’inscription à Windows Device Updates | ☑️ | | `SecurityFeatures` | Protection avancée contre les menaces et analyses de sécurité (nécessite des licences MDE) | | | `Client` | RealmJoin Agent — application cliente pour la gestion des appareils | | ## Dépannage {% hint style="warning" %} **« Privilèges insuffisants »** — la création de Service Principals et l’octroi d’autorisations d’application nécessitent un compte disposant des privilèges appropriés, par exemple *Global Administrator* ou *Privileged Role Administrator*. Voir [Prérequis](#prerequisites). {% endhint %} {% hint style="warning" %} **« Besoin d’approbation de l’administrateur » ou erreur de consentement lors de la connexion** — la connexion utilise le **Azure PowerShell** application de première partie. Si votre tenant limite le consentement utilisateur, un administrateur doit accorder une fois le consentement d’administrateur à cette application. {% endhint %} {% hint style="warning" %} **« Le module RealmJoin est obsolète - l’exécution ne peut pas continuer »** — chaque commande vérifie une fois par session que vous exécutez la dernière version publiée. Installez la version actuelle, puis fermez la session et ouvrez-en une nouvelle : ```powershell Install-Module -Name RealmJoin -Force -Scope CurrentUser ``` {% endhint %} {% hint style="warning" %} **Un conflit de version du module est signalé** — un `Az.*` module d’une version différente de celle verrouillée par le module est déjà chargé. Cela ne peut pas être corrigé dans la session en cours : fermez PowerShell, ouvrez une nouvelle session et exécutez à nouveau la commande. {% endhint %} Si le module est introuvable, vérifiez que la PowerShell Gallery est disponible et réinstallez : ```powershell Get-PSRepository Install-Module -Name RealmJoin -Force -Scope CurrentUser ``` ### Obtenir de l’aide ```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/fr/deploiement/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.