> 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/automatisation/runbooks.md).

# Runbooks

Automatisez les opérations quotidiennes dans votre environnement.

{% 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 [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 de 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 passes d’accès temporaires (TAPs)
* Rapports sur l’utilisation des licences M/O365
* Gestion des alias de messagerie

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

![](https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FMc2l3m04STPICTYA1oRR%2Fuser%20rb.png?alt=media\&token=9caed6bc-dee4-41b1-b937-b422cdf5022f)

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

RealmJoin est actuellement en train de migrer de Windows PowerShell v5.1 vers 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 compte Automation est activée.
{% endhint %}

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F6zw45i9VYQdWogZMGM3T%2Fre.png?alt=media&amp;token=6d5b6db5-e8d4-49dd-9682-bcad7300b98e" alt=""><figcaption></figcaption></figure>

Lors de l’exécution d’un [synchronisation](#syncing-from-the-shared-repository), un environnement d’exécution PowerShell personnalisé « RJ-PowerShell-7.4 » sera créé, 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 traitement variables** qui pourraient provoquer des erreurs comme 404, veuillez **resynchroniser**. 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="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FG8FrcvNoMJWIrHJQm0hk%2Fimage.png?alt=media&amp;token=33d5dee3-2d63-42b8-b1b4-9ad85d20aacb" alt=""><figcaption></figcaption></figure>

## Runbooks courants

RealmJoin maintient un [dépôt 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 aussi y inclure vos propres runbooks personnalisés.

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

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

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

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

![Déclenchez la synchronisation de vos runbooks](https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F0KIq5zPxTcdqcZFKKRMu%2Fimage.png?alt=media\&token=18499a55-69c7-4235-8da1-da79441660f9)

Attendez le message « Sync completed ». Veuillez laisser la fenêtre du navigateur ouverte pendant l’exécution du processus de synchronisation.

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

## personnalisation

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

* utiliser des modèles pour les informations courantes, comme les emplacements des bureaux
* préremplir / préconfigurer des paramètres, par exemple ne pas autoriser la suppression de l’objet utilisateur lors de la désaffectation
* masquer certains champs d’entrée / paramètres

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

## Portées

Les runbooks dans RealmJoin Portal sont définis pour les différents types d’objets de votre environnement. Certains runbooks fonctionnent au niveau du tenant / de l’organisation, par exemple la création d’un rapport de licences. Certains runbooks sont définis par utilisateur, par exemple la réinitialisation d’un mot de passe. RealmJoin Portal utilise cette portée pour proposer les runbooks appropriés dans le bon contexte.

Voir [Conventions de nommage](https://docs.realmjoin.com/fr/automatisation/runbooks/naming-conventions.md) pour en savoir plus sur la façon dont les runbooks sont définis pour certains objets de votre environnement.

## Contrôle d’accès

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

* n’autoriser l’accès à ce runbook qu’aux opérateurs de 3e niveau
* n’autoriser que notre équipe de support VIP à modifier l’adresse e-mail du PDG

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


---

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