# Runbooks {% embed url="" %} 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. Die Automatisierung dieser Aufgaben senkt das Risiko manueller Fehler und ermöglicht eine bessere Nachverfolgung von Aktionen. Einige gängige Aufgaben, bei deren Automatisierung RealmJoin Ihnen helfen kann, sind: * Benutzer-Lebenszyklusvorgänge (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 anbieten, um die täglichen Abläufe zu vereinfachen und die Qualität ihrer Arbeit 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 Environments RealmJoin befindet sich derzeit im Prozess der Migration von Windows PowerShell v5.1 zu PowerShell v7.4 [Runtime Environment](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment). {% hint style="info" %} Stellen Sie sicher, dass die Funktion "Runtime Environment" in Ihrem Automation Account aktiviert ist. {% endhint %}
Beim Ausführen eines [Synchronisierungsvorgangs](#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 benötigte PowerShell-Module automatisch importiert. {% hint style="info" %} Aufgrund **unterschiedlicher Prozessdauern** die Fehler wie 404 verursachen könnten, **bitte erneut synchronisieren**. Außerdem warten Sie bitte 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" auswählen, um sie manuell zu migrieren. Stellen Sie sicher, dass Sie die Runbooks "veröffentlichen", damit die Änderung wirksam wird. {% endhint %}
## Gängige Runbooks RealmJoin pflegt ein [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](https://docs.realmjoin.com/de/connecting-azure-automation/required-permissions#b31d828b-8bcb-45fc-8d72-5418777a5376) in Ihre Umgebung zu importieren und bietet Ihrem Support- und Administrationsteam eine einfache, nicht-technische Oberfläche für die Aufgaben, die die Runbooks abdecken. ### Synchronisierung aus dem Shared Repository Sie können eine Synchronisierung aus dem Shared Repository mit Ihrem Azure Automation-Konto auslösen, indem Sie bei ![Eine 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 ausgeführt wird. Wie in der [Namenskonvention](https://docs.realmjoin.com/de/automatisierung/runbooks/naming-conventions) beschrieben, werden dadurch Runbooks zum verbundenen Azure Automation Account hinzugefügt, aktualisiert und bei Bedarf entfernt, um mit dem Shared Repository von RealmJoin synchron zu bleiben. Dies stellt sicher, 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 verwenden, wie etwa Bürostandorte * Parameter vorbefüllen / vorkonfigurieren, z. B. um das Löschen des Benutzerobjekts beim Offboarding nicht zuzulassen * Bestimmte Eingaben/Parameter ausblenden Siehe [Runbook-Anpassung ](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-customization). ## Bereiche Runbooks im RealmJoin Portal sind den verschiedenen Objekttypen in Ihrer Umgebung zugeordnet. Einige Runbooks arbeiten auf Mandanten-/Organisationsebene, wie etwa das Erstellen eines Lizenzberichts. Andere Runbooks sind pro Benutzer zugeordnet, wie etwa das Zurücksetzen eines Kennworts. RealmJoin Portal nutzt diese Zuordnung, um die richtigen Runbooks im richtigen Kontext anzubieten. Siehe [Benennungskonventionen](https://docs.realmjoin.com/de/automatisierung/runbooks/naming-conventions) um zu erfahren, wie Runbooks bestimmten Objekten in Ihrer Umgebung zugeordnet werden. ## Zugriffskontrolle Zugriff/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 CEOs zu ändern Siehe [Runbook-Berechtigungen](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-permissions) für Details zur Umsetzung solcher Regeln in Ihrer Umgebung.