# 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, 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. Die Automatisierung dieser Aufgaben verringert das Risiko manueller Fehler und ermöglicht eine bessere Nachverfolgung von Aktionen.

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

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

Sie können RealmJoin Portal Ihren Support- und Administrationsteams bereitstellen, 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 Erfahrung „Runtime Environment“ 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 Environment „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 von **unterschiedlichen Prozessdauern** die Fehler wie 404 verursachen können, **synchronisieren Sie erneut**. Warten Sie außerdem ein paar 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“ nutzen, um sie manuell zu migrieren. Stellen Sie sicher, dass Sie die Runbooks „publish“, 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 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 Ihren Support- und Administrationsmitarbeitern 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 unter

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

![eine Synchronisierung Ihrer Runbooks auslösen](/files/e274cc1e23c492c7fe02ef5f089a5ca5884e7340)

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

Wie in der [Namenskonvention](/de/automatisierung/runbooks/naming-conventions.md) beschrieben, werden dadurch 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äufig benötigte Informationen verwenden, wie z. B. Standorte von Büros
* Parameter vorbefü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).

## Bereiche

Runbooks im RealmJoin Portal sind den verschiedenen Objekttypen in Ihrer Umgebung zugeordnet. Einige Runbooks arbeiten auf Tenant-/Organisationsebene, z. B. das Erstellen eines Lizenzberichts. Einige Runbooks sind pro Benutzer zugeordnet, z. B. das Zurücksetzen eines Passworts. RealmJoin Portal verwendet diese Zuordnung, um die passenden Runbooks im richtigen Kontext anzubieten.

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

## Zugriffskontrolle

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

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

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


---

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