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

# Runbooks

Automatisieren Sie alltägliche Abläufe in Ihrer Umgebung.

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

RealmJoin bietet Administratoren die Möglichkeit, Aufgaben zu automatisieren, indem sie [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) verwendet werden, um [PowerShell-Runbooks](https://docs.microsoft.com/en-us/azure/automation/automation-runbook-types#powershell-runbooks).

Runbooks sind Skripte, die Aufgaben automatisieren, die normalerweise von einem Support-Engineer / Operator oder Administrator ausgeführt werden müssen. Durch die Automatisierung dieser Aufgaben wird das Risiko manueller Fehler verringert und eine bessere Nachvollziehbarkeit der Aktionen ermöglicht.

Einige häufige Aufgaben, bei denen RealmJoin Ihnen bei der Automatisierung helfen kann, sind:

* Benutzer-Lebenszyklus-Operationen (Onboarding/Offboarding von Benutzern)
* Erstellen temporärer Zugriffspässe (TAPs)
* Berichterstellung zur M/O365-Lizenznutzung
* Verwalten von E-Mail-Aliasen

Sie können das RealmJoin Portal Ihren Support- und Administrationsteams zur Verfügung stellen, um Ihre täglichen Abläufe zu vereinfachen und ihre Qualität zu verbessern.

![](https://2298793958-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 zu PowerShell-Runtime-Umgebungen

RealmJoin befindet sich derzeit im Prozess der Migration von Windows PowerShell v5.1 zu einer PowerShell v7.4 [Laufzeitumgebung](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment).

{% hint style="info" %}
Stellen Sie sicher, dass die Erfahrung „Runtime Environment“ in Ihrem Automation-Konto aktiviert ist.
{% endhint %}

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

Wenn Sie eine [Synchronisierung](#syncing-from-the-shared-repository) durchführen, wird eine benutzerdefinierte PowerShell-Runtime-Umgebung „RJ-PowerShell-7.4“ erstellt, synchronisierte Runbooks werden in diese Umgebung verschoben. Falls erforderlich, werden die erforderlichen PowerShell-Module automatisch importiert.

{% hint style="info" %}
Aufgrund von **unterschiedlichen Prozessdauern** die möglicherweise Fehler wie 404 verursachen, führen Sie bitte **erneut eine Synchronisierung durch**. Warten Sie außerdem einige Minuten, bevor Sie nach der Migration das erste Runbook starten.
{% endhint %}

{% hint style="warning" %}
**Benutzerdefinierte / nicht synchronisierte Runbooks werden nicht automatisch aktualisiert.**

Sie können Azure Portal verwenden und bei diesen Runbooks „Edit in Portal“ verwenden, um sie manuell zu migrieren. Stellen Sie sicher, dass Sie die Runbooks „veröffentlichen“, damit die Änderung wirksam wird.
{% endhint %}

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

## Häufige Runbooks

RealmJoin pflegt eine [gemeinsam genutzten Online-Repository für Runbooks](https://github.com/realmjoin/realmjoin-runbooks). Sie sollen viele häufige Vorgänge abdecken, die in den meisten Umgebungen vorkommen. Die Runbooks werden kontinuierlich aktualisiert und verbessert. Natürlich können Sie auch Ihre eigenen benutzerdefinierten Runbooks einbinden.

RealmJoin Portal ermöglicht es Ihnen, diese Runbooks über [RealmJoin Runbook Management App](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) in Ihre Umgebung zu importieren und bietet Ihrem Support- und Administrationspersonal eine einfache, nichttechnische Oberfläche für die Aufgaben, die von den Runbooks abgedeckt werden.

### Synchronisierung aus dem gemeinsamen Repository

Sie können eine Synchronisierung aus dem gemeinsamen Repository mit Ihrem Azure Automation-Konto auslösen, indem Sie bei

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

![Synchronisierung Ihrer Runbooks auslösen](https://2298793958-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)

Warten Sie auf die Meldung "Sync completed". Bitte lassen Sie das Browserfenster geöffnet, während der Synchronisierungsvorgang läuft.

Wie in der [Namenskonvention](https://docs.realmjoin.com/de/automatisierung/runbooks/naming-conventions.md) beschrieben, werden dadurch Runbooks im verbundenen Azure Automation-Konto hinzugefügt, aktualisiert und, falls erforderlich, entfernt, damit sie mit dem gemeinsamen Repository von RealmJoin synchronisiert bleiben. Dadurch wird sichergestellt, dass Ihre Runbooks auf dem neuesten Stand sind, einschließlich Verbesserungen, Fehlerbehebungen und neuer Funktionen.

## Anpassung

Sie können vorhandene und neue Runbooks an Ihre Umgebung anpassen. Zum Beispiel können Sie

* Vorlagen für häufig benötigte Informationen verwenden, wie etwa Bürostandorte
* Parameter vorbefüllen / vorkonfigurieren, z. B. um beim Offboarding das Löschen des Benutzerobjekts nicht zuzulassen
* Bestimmte Eingaben/Parameter ausblenden

Siehe [Runbook-Anpassung ](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-customization.md)für weitere Details.

## Bereiche

Runbooks im RealmJoin Portal sind den verschiedenen Objekttypen in Ihrer Umgebung zugeordnet. Einige Runbooks arbeiten auf Tenant-/Organisationsebene, wie zum Beispiel das Erstellen eines Lizenzberichts. Einige Runbooks sind pro Benutzer zugeordnet, wie zum Beispiel das Zurücksetzen eines Kennworts. Das RealmJoin Portal nutzt diese Zuordnung, um die passenden Runbooks im richtigen Kontext anzubieten.

Siehe [Benennungskonventionen](https://docs.realmjoin.com/de/automatisierung/runbooks/naming-conventions.md) um mehr über die Zuordnung von Runbooks zu bestimmten Objekten in Ihrer Umgebung zu erfahren.

## Zugriffskontrolle

Der Zugriff bzw. die Berechtigungen zur Verwendung bestimmter Runbooks können auf Runbook-Ebene granular vergeben werden. Beispielsweise könnten Runbook-Berechtigungen Ihnen helfen, Folgendes umzusetzen:

* Den Zugriff auf dieses Runbook nur den Operatoren der 3. Ebene zu erlauben
* Nur unserem VIP-Support-Team erlauben, die E-Mail-Adresse des CEOs zu ändern

Siehe [Runbook-Berechtigungen](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-permissions.md) für Details dazu, wie Sie solche Regeln in Ihrer Umgebung implementieren.


---

# 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/de/automatisierung/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.
