> 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 épinglé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 qui peut **créer des service principals et accorder des autorisations d’application** dans Microsoft Entra ID — par exemple *Global Administrator* ou *Administrateur de rôle privilégié*
* La connexion s’effectue via `Connect-AzAccount`, qui utilise l’ **Azure PowerShell** application propriétaire. Les tenants qui restreignent le consentement des utilisateurs peuvent nécessiter 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

Un abonnement Azure n’est nécessaire que pour les ressources Azure (`Set-RJLogAnalyticsWorkspace`, `Set-RJAutomationAccount`). `New-RJTenant` et `Update-RJTenant` fonctionnent dans un tenant sans aucun abonnement ; connectez-vous-y avec `Connect-AzAccount -Tenant <tenant-id>` en premier.

## Configuration recommandée

La commande de configuration affichée par le RealmJoin Portal s’exécute `Complete-RJTenantOnboarding` (alias de `Update-RJTenant`) sans sélection de fonctionnalité. Elle attribue les autorisations de la fonctionnalité obligatoire et de toutes les fonctionnalités par défaut :

* Fonctionnalité principale du portail (`RealmJoinPortal`, obligatoire)
* Intune LAPS (`IntuneLAPS`)
* Données de connexion (`ShowSignin`)
* Autopilot (`Autopilot`)
* Actions sur les appareils Intune (`DeviceIntuneActions`)
* Scripts de remédiation (`DeviceHealthScript`)
* Clés de récupération BitLocker (`BitLockerRecoveryKeys`)
* Inscription des mises à jour des appareils Windows (`WindowsDeviceUpdateEnrollment`)

Les fonctionnalités déjà configurées dans le tenant, par exemple `SecurityFeatures` ou `Client`, sont conservées. 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 une ligne de version mineure fixe de chaque `modules Az.*` module (`Az.Accounts` 5.5.x, `Az.Resources` 10.2.x, `Az.Automation` 1.12.x) ; si une autre version est déjà chargée dans la session — ce qui est généralement le cas dans Cloud Shell —, l’exécution s’arrête avec un conflit de version qui ne peut pas être résolu sans ouvrir une nouvelle session.

Une session avec élévation (« Exécuter en tant qu’administrateur ») n’est pas nécessaire : les modules sont installés avec `-Scope CurrentUser`.
{% endstep %}

{% step %}

#### Copiez et exécutez le script d’onboarding RealmJoin

Le script vous invitera à vous connecter à Azure. Utilisez un compte qui peut créer des service principals et accorder des autorisations d’application, par exemple votre Administrateur général.

Le jeton de la commande relie l’exécution à votre tenant dans le RealmJoin Portal. Il est valide pendant une heure ; s’il a expiré, ouvrez de nouveau la page Configuration avancée dans le portail pour obtenir une commande avec un nouveau jeton.

```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 de progression détaillés pendant l’exécution.
{% endhint %}

<figure><img src="https://1100180853-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 %}

#### Commencez à utiliser RealmJoin

Une fois les autorisations attribuées, la commande envoie le jeton à l’API RealmJoin. La page Configuration avancée dans le portail vérifie périodiquement si le jeton a été utilisé, puis vous redirige vers le portail. Laissez la page ouverte pendant l’exécution de la commande.

Si le service principal RealmJoin Portal n’existait pas déjà dans le tenant, la commande ouvre également le RealmJoin Portal dans votre navigateur.

{% 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, basée sur des menus, couvrant la configuration du tenant, les modifications de configuration, l’espace de travail Log Analytics et le compte Automation :

```powershell
Show-RJInteractiveSetup
```

Pour examiner les fonctionnalités disponibles avant de configurer quoi que ce soit :

```powershell
Show-RJFeatureInfo
```

### Configuration personnalisée

`New-RJTenant` configure un tenant avec exactement les fonctionnalités sélectionnées. Utilisez-la pour les tenants qui ne sont pas encore configurés.

{% hint style="warning" %}
Sur un tenant déjà configuré, `New-RJTenant` supprime les autorisations de chaque fonctionnalité configurée qui ne fait pas partie de la sélection et supprime les service principals laissés sans autorisations. Par exemple, `New-RJTenant` sans paramètres supprime `SecurityFeatures` et `Client`. Pour modifier une configuration existante, utilisez [`Update-RJTenant`](#updating-existing-configuration).
{% endhint %}

#### Fonctionnalités par défaut

Active la fonctionnalité principale obligatoire du portail ainsi que les fonctionnalités optionnelles par défaut (toutes sauf `Client`, `SecurityFeatures` et `AndroidApps`):

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

#### Fonctionnalités minimales (fonctionnalités obligatoires uniquement)

```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 lorsqu’elles sont disponibles (par exemple, `Group.ReadWrite.All` devient `Group.Read.All`):

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

Trois fonctionnalités n’ont pas de variante en lecture seule et conservent leurs autorisations avec `-ReadOnly`:

| Fonctionnalité                  | Autorisation                                              |
| ------------------------------- | --------------------------------------------------------- |
| `DeviceIntuneActions`           | `DeviceManagementManagedDevices.PrivilegedOperations.All` |
| `WindowsDeviceUpdateEnrollment` | `WindowsUpdates.ReadWrite.All`                            |
| `AndroidApps`                   | `DeviceManagementConfiguration.ReadWrite.All`             |

Pour une configuration sans autorisations d’écriture, omettez ces fonctionnalités :

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

#### Sélection personnalisée des fonctionnalités

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

### Mise à jour de la configuration existante

`Update-RJTenant` ajuste un tenant déjà configuré. L’alias `Complete-RJTenantOnboarding` peut être utilisé indifféremment avec `Update-RJTenant`.

* Sans `-Features`, `-All`, `-AddFeatures` ou `-RemoveFeatures`, les fonctionnalités déjà configurées dans le tenant sont conservées et les fonctionnalités par défaut sont ajoutées. Rien n’est supprimé.
* `-Features` remplace la configuration : les fonctionnalités configurées qui ne figurent pas dans la liste sont supprimées, y compris leur service principal. Une liste vide est rejetée.
* `-AddFeatures` et `-RemoveFeatures` modifiez uniquement les fonctionnalités nommées.
* À chaque exécution, les applications héritées RealmJoin sont également supprimées du tenant, voir [Passer de la configuration rapide](#switching-from-quick-setup).

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

bascule les fonctionnalités configurées et les fonctionnalités par défaut vers leurs autorisations en lecture seule. Les fonctionnalités répertoriées sous [Autorisations en lecture seule](#read-only-permissions) conservent leurs autorisations d’écriture.

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

Associé à `-AddFeatures`, `-ReadOnly` s’applique uniquement aux fonctionnalités ajoutées ; les autorisations des fonctionnalités déjà configurées restent inchangées.

#### Aperçu des modifications

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

### Ressources Azure

Le module déploie également les ressources Azure associées utilisées par RealmJoin. Celles-ci ne sont pas des fonctionnalités d’autorisation Graph et ne sont pas sélectionnées avec `-Features`:

* `Set-RJLogAnalyticsWorkspace` — déploie l’espace de travail Log Analytics avec ses tables personnalisées et ses règles de collecte de données, voir [Connexion de l’espace de travail Azure Log Analytics](https://docs.realmjoin.com/fr/supervision-et-journaux/log-analytics.md)
* `Set-RJAutomationAccount` — déploie le compte Automation RealmJoin avec une identité managée et les autorisations dont il a besoin, voir [Connexion à Azure Automation](https://docs.realmjoin.com/fr/automatisation/connecting-azure-automation.md)

Les deux commandes sont générées avec les paramètres correspondants et un jeton d’onboarding sur la page de paramètres concernée dans le RealmJoin Portal.

## Fonctionnalités disponibles

Utilisez ces noms de fonctionnalités 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 marquées ci-dessous ; **SecurityFeatures**, **Client** et **AndroidApps** doivent être sélectionnées explicitement.

| Fonctionnalité                  | Description                                                                                                                                                                                                      | Valeur par défaut |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------: |
| `RealmJoinPortal`               | Fonctionnalité principale du portail pour le libre-service utilisateur et l’interaction administrateur (obligatoire)                                                                                             |         ☑️        |
| `IntuneLAPS`                    | Récupérer et gérer les mots de passe administrateur local via Intune LAPS                                                                                                                                        |         ☑️        |
| `ShowSignin`                    | Afficher l’historique de connexion des utilisateurs et les journaux d’audit                                                                                                                                      |         ☑️        |
| `Autopilot`                     | Afficher les profils et l’état de déploiement Windows Autopilot                                                                                                                                                  |         ☑️        |
| `DeviceIntuneActions`           | Exécuter des actions privilégiées sur les appareils (synchronisation, redémarrage, effacement, etc.)                                                                                                             |         ☑️        |
| `DeviceHealthScript`            | Gérer et déployer des scripts PowerShell de remédiation sur les appareils                                                                                                                                        |         ☑️        |
| `BitLockerRecoveryKeys`         | Afficher les clés de récupération BitLocker pour les appareils gérés                                                                                                                                             |         ☑️        |
| `WindowsDeviceUpdateEnrollment` | Gérer l’inscription aux mises à jour Windows Device                                                                                                                                                              |         ☑️        |
| `SecurityFeatures`              | [Intégration avec Defender for Endpoint](https://docs.realmjoin.com/fr/ugd-management/defender-integration.md) sur les pages des appareils (nécessite des licences MDE)                                          |                   |
| `Client`                        | RealmJoin Agent — application cliente pour la gestion des appareils                                                                                                                                              |                   |
| `AndroidApps`                   | [Déploiement d’application Android](https://docs.realmjoin.com/fr/gestion-des-applications/packages/android-apps-managed-google-play.md) via Managed Google Play (`DeviceManagementConfiguration.ReadWrite.All`) |                   |

## Passer de la configuration rapide

Un tenant configuré avec la configuration rapide utilise l’ **RealmJoin Portal - Core Features** enregistrement d’application, qui contient toutes les autorisations du portail. Pour le déplacer vers la configuration avancée, allez à **Organisation → Fonctionnalités** dans le RealmJoin Portal et sélectionnez **Passer en mode avancé** sur la carte **Configuration avancée** Le portail affiche alors la commande d’onboarding avec un jeton, comme décrit sous [Configuration recommandée](#recommended-setup).

<figure><img src="https://1100180853-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>Carte de configuration avancée pour les tenants en configuration rapide</p></figcaption></figure>

Lorsque la commande s’exécute, le module crée les service principals pour les fonctionnalités sélectionnées et supprime l’ **RealmJoin Portal - Core Features** enregistrement d’application en tant qu’application héritée. Une fois les nouvelles autorisations en place, le portail bascule le tenant vers la configuration avancée.

{% hint style="warning" %}
Le passage est irréversible. Une fois l’enregistrement de l’application Core Features supprimé, les autorisations sont gérées uniquement avec le module PowerShell RealmJoin.
{% endhint %}

## 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 doté des privilèges appropriés, par exemple *Global Administrator* ou *Administrateur de rôle privilégié*. Voir [Prérequis](#prerequisites).
{% endhint %}

{% hint style="warning" %}
**"Besoin d’une approbation administrateur" ou erreur de consentement lors de la connexion** — la connexion utilise le **Azure PowerShell** application native. Si votre tenant limite le consentement des utilisateurs, un administrateur doit accorder une fois le consentement 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" %}
**"Échec de l’authentification (401). Le jeton peut être invalide ou expiré."** — les autorisations ont été attribuées, mais le tenant n’a pas pu être enregistré auprès de RealmJoin parce que le jeton d’onboarding a expiré (après une heure) ou est invalide. Ouvrez de nouveau la page Configuration avancée dans le RealmJoin Portal et exécutez la commande avec le nouveau jeton. La relancer ne modifie pas les autorisations déjà en place.
{% endhint %}

{% hint style="warning" %}
**Un conflit de version du module est signalé** — un `modules Az.*` module dans une version autre que celle épinglé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 PowerShell Gallery est disponible et réinstallez-le :

```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=<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.
