# Runbooks

{% embed url="<https://www.youtube.com/watch?v=TfL7xRasVUg>" %}

RealmJoin offre aux administrateurs la possibilité d’automatiser des tâches en utilisant [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) pour exécuter [des Runbooks PowerShell](https://docs.microsoft.com/en-us/azure/automation/automation-runbook-types#powershell-runbooks).

Les Runbooks sont des scripts qui automatisent des tâches qui doivent normalement être exécutées par un ingénieur support / opérateur ou un administrateur. L’automatisation de ces tâches réduit le risque d’erreur manuelle et permet un meilleur audit des actions.

Voici quelques tâches courantes que RealmJoin peut vous aider à automatiser :

* Opérations du cycle de vie des utilisateurs (intégration/désintégration des utilisateurs)
* Création de Temporary Access Pass (TAP)
* Rapport sur l’utilisation des licences M/O365
* Gestion des alias de messagerie

Vous pouvez proposer RealmJoin Portal à vos équipes de support et d’administration afin de simplifier et d’améliorer la qualité de vos opérations quotidiennes.

![](/files/4921efaaf0b38fc7c3b82c44fa7c0d36a08f61d3)

### Migration vers les environnements d’exécution PowerShell

RealmJoin est actuellement en train de migrer de Windows PowerShell v5.1 vers un PowerShell v7.4 [Environnement d’exécution](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment).

{% hint style="info" %}
Assurez-vous que l’expérience « Runtime Environment » dans votre Automation Account est activée.
{% endhint %}

<figure><img src="/files/d618fe37046c0e4883ee0505d78fb8493eed9a8c" alt=""><figcaption></figcaption></figure>

Lors de l’exécution d’un [sync](#syncing-from-the-shared-repository), un environnement d’exécution PowerShell personnalisé « RJ-PowerShell-7.4 » sera créé, et les runbooks synchronisés seront déplacés vers cet environnement. Si nécessaire, les modules PowerShell requis seront importés automatiquement.

{% hint style="info" %}
En raison de **durées de processus variables** qui peuvent provoquer des erreurs comme 404, veuillez **synchroniser à nouveau**. De plus, attendez quelques minutes avant de lancer le premier runbook après la migration.
{% endhint %}

{% hint style="warning" %}
**Les runbooks personnalisés / non synchronisés ne seront pas mis à niveau automatiquement.**

Vous pouvez utiliser Azure Portal et l’option « Edit in Portal » sur ces runbooks pour les migrer manuellement. Assurez-vous de « publier » les runbooks pour que la modification prenne effet.
{% endhint %}

<figure><img src="/files/398ee97537086fcb787f58b1b8c7cd4a97b0d935" alt=""><figcaption></figcaption></figure>

## Runbooks courants

RealmJoin maintient un [référentiel en ligne partagé de runbooks](https://github.com/realmjoin/realmjoin-runbooks). Ils visent à couvrir de nombreuses opérations courantes présentes dans la plupart des environnements. Les runbooks sont continuellement mis à jour et améliorés. Bien entendu, vous pouvez également inclure vos propres runbooks personnalisés.

RealmJoin Portal vous permet d’importer ces runbooks via [l’application RealmJoin Runbook Management](/fr/automatisation/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) dans votre environnement et offre à votre personnel support et administration une interface simple et non technique pour les tâches couvertes par les runbooks.

### Synchronisation depuis le dépôt partagé

Vous pouvez lancer une synchronisation depuis le dépôt partagé vers votre compte Azure Automation en cliquant sur « Sync runbooks with upstream » dans

<https://portal.realmjoin.com/settings/general>

![Déclencher une synchronisation de vos runbooks](/files/b7c17ccbd5cf9439989cbfd76c7f872ae30da685)

Attendez le message « Sync completed ». Veuillez garder la fenêtre du navigateur ouverte pendant que le processus de synchronisation est en cours.

Comme décrit dans la [convention de nommage](/fr/automatisation/runbooks/naming-conventions.md) cela ajoutera, mettra à jour et, si nécessaire, supprimera des runbooks du compte Azure Automation connecté afin qu’il soit synchronisé avec le dépôt partagé de RealmJoin. Cela garantit que vos runbooks sont à jour, y compris les améliorations, corrections et nouvelles fonctionnalités.

## Personnalisation

Vous pouvez personnaliser les runbooks existants et nouveaux pour votre environnement. Par exemple, vous pouvez

* Utiliser des modèles pour des informations courantes, comme les emplacements de bureau
* Préremplir / préconfigurer des paramètres, par exemple pour ne pas autoriser la suppression de l’objet utilisateur lors de la désintégration
* Masquer certains champs de saisie/paramètres

Voir [Personnalisation des runbooks ](/fr/automatisation/runbooks/runbook-customization.md)pour plus de détails.

## Périmètres

Dans RealmJoin Portal, les runbooks sont associés à différents types d’objets dans votre environnement. Certains runbooks fonctionnent au niveau du Tenant / de l’organisation, comme la création d’un rapport de licences. Certains runbooks sont associés à un utilisateur individuel, comme la réinitialisation d’un mot de passe. RealmJoin Portal utilise ce périmètre pour proposer les bons runbooks dans le bon contexte.

Voir [Conventions de nommage](/fr/automatisation/runbooks/naming-conventions.md) pour en savoir plus sur la manière dont les runbooks sont associés à certains objets dans votre environnement.

## Contrôle d’accès

L’accès / les autorisations pour utiliser certains runbooks peuvent être accordés de manière granulaire au niveau d’un runbook. Par exemple, les autorisations de runbook pourraient vous aider à :

* Autoriser l’accès à ce runbook uniquement aux opérateurs du 3e niveau
* Autoriser uniquement notre équipe de support VIP à modifier l’adresse e-mail du CEO

Voir [Autorisations des runbooks](/fr/automatisation/runbooks/runbook-permissions.md) pour plus de détails sur la manière de mettre en œuvre de telles règles dans votre environnement.


---

# 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.realmjoin.com/fr/automatisation/runbooks.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.
