> 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

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

RealmJoin bietet Administratoren die Möglichkeit, Aufgaben zu automatisieren, indem [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) auszuführen [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 Nachverfolgung der Aktionen ermöglicht.

Zu den häufigen Aufgaben, bei deren Automatisierung RealmJoin helfen kann, gehören:

* Benutzer-Lifecycle-Operationen (Onboarding/Offboarding von Benutzern)
* Erstellen von Temporary Access Passes (TAPs)
* Berichterstellung zur M/O365-Lizenznutzung
* Verwalten von E-Mail-Aliasen

Sie können RealmJoin Portal Ihren Support- und Verwaltungsteams anbieten, um die Qualität Ihrer täglichen Abläufe zu vereinfachen und zu verbessern.

![](/files/29ae4f5d0d7fb3b5deb6f094112c0dbe9c19ab39)

### Migration zu PowerShell-Runtime-Umgebungen

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

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

<figure><img src="/files/64fb331580c8b362b0b012f8733e19f41aa34cc1" alt=""><figcaption></figcaption></figure>

Beim Ausführen einer [Synchronisierung](#syncing-from-the-shared-repository), wird eine benutzerdefinierte PowerShell-Runtime-Umgebung „RJ-PowerShell-7.4“ erstellt, synchronisierte Runbooks werden in diese Umgebung verschoben. Falls erforderlich, werden die benötigten PowerShell-Module automatisch importiert.

{% hint style="info" %}
Aufgrund **unterschiedlicher Prozesslaufzeiten** die Fehler wie 404 verursachen können, bitte **erneut synchronisieren**. Warten Sie außerdem einige Minuten, bevor Sie das erste Runbook nach der Migration starten.
{% endhint %}

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

Sie können das 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="/files/bf3ee478ca4ffcc14b50d310a5bebec7c4b96d6b" alt=""><figcaption></figcaption></figure>

## Häufige Runbooks

RealmJoin pflegt eine [gemeinsamen 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.

Das RealmJoin Portal ermöglicht Ihnen, diese Runbooks über [RealmJoin Runbook Management App](/de/automatisierung/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) in Ihre Umgebung zu importieren und bietet Ihrem Support- und Verwaltungspersonal eine einfache, nicht-technische Oberfläche für die Aufgaben, die die Runbooks abdecken.

### Synchronisierung aus dem gemeinsamen Repository

Sie können eine Synchronisierung vom gemeinsamen Repository zu Ihrem Azure Automation-Konto auslösen, indem Sie bei

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

![Lösen Sie eine Synchronisierung Ihrer Runbooks aus](/files/e274cc1e23c492c7fe02ef5f089a5ca5884e7340)

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

Wie in der [Benennungskonvention](/de/automatisierung/runbooks/naming-conventions.md) werden Runbooks aus dem verbundenen Azure Automation-Konto hinzugefügt, aktualisiert und bei Bedarf entfernt, sodass sie mit dem gemeinsamen Repository von RealmJoin synchron sind. 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äufige Informationen wie Bürostandorte verwenden
* Parameter vorab ausfüllen / vorkonfigurieren, z. B. um das Löschen des Benutzerobjekts beim Offboarding nicht zuzulassen
* Bestimmte Eingaben/Parameter ausblenden

Siehe [Runbook-Anpassung ](/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 etwa das Erstellen eines Lizenzberichts. Einige Runbooks sind pro Benutzer zugeordnet, wie etwa das Zurücksetzen eines Kennworts. Das RealmJoin Portal nutzt diese Zuordnung, um die richtigen Runbooks im richtigen Kontext anzubieten.

Siehe [Namenskonventionen](/de/automatisierung/runbooks/naming-conventions.md) um zu erfahren, wie Runbooks bestimmten Objekten in Ihrer Umgebung zugeordnet werden.

## Zugriffskontrolle

Zugriff/Berechtigungen für die Nutzung bestimmter Runbooks können granular auf Runbook-Ebene vergeben werden. Zum Beispiel könnten Runbook-Berechtigungen Ihnen helfen:

* Den Zugriff auf dieses Runbook nur für Operatoren der 3. Ebene zulassen
* Nur unserem VIP-Supportteam erlauben, die E-Mail-Adresse des CEO zu ändern

Siehe [Runbook-Berechtigungen](/de/automatisierung/runbooks/runbook-permissions.md) für Details dazu, wie solche Regeln in Ihrer Umgebung implementiert werden.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/de/automatisierung/runbooks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
