> 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 mithilfe von [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-Ingenieur / Operator oder Administrator ausgeführt werden müssen. Die Automatisierung dieser Aufgaben verringert das Risiko manueller Fehler und ermöglicht eine bessere Nachverfolgbarkeit von Aktionen.

Einige gängige Aufgaben, bei denen RealmJoin Ihnen bei der Automatisierung helfen kann, sind:

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

Sie können RealmJoin Portal Ihren Support- und Administrationsteams 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-Umgebung](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment).

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

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

Beim Ausführen eines [Synchronisierungsvorgangs](#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, führen Sie bitte **die Synchronisierung erneut durch**. 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 "Im Portal bearbeiten" nutzen, 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>

## Gängige Runbooks

RealmJoin pflegt eine [gemeinsamen Online-Repository für Runbooks](https://github.com/realmjoin/realmjoin-runbooks). Sie sollen viele gängige 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](/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 aus dem gemeinsamen Repository mit 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 Synchronisierungsvorgang läuft.

Wie im [Namenskonvention](/de/automatisierung/runbooks/naming-conventions.md) dadurch werden Runbooks im verbundenen Azure Automation Account hinzugefügt, aktualisiert und bei Bedarf entfernt, damit 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, etwa beim Erstellen eines Lizenzberichts. Einige Runbooks sind pro Benutzer zugeordnet, etwa beim Zurücksetzen eines Passworts. 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 zur Nutzung bestimmter Runbooks können granular auf Runbook-Ebene vergeben werden. Beispielsweise können Runbook-Berechtigungen Ihnen helfen:

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

Siehe [Runbook-Berechtigungen](/de/automatisierung/runbooks/runbook-permissions.md) für Details zur Umsetzung solcher Regeln in Ihrer Umgebung.


---

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

```
GET https://docs.realmjoin.com/de/automatisierung/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.
