> 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="" %} 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 Supportingenieur / Operator oder Administrator ausgeführt werden müssen. Die Automatisierung dieser Aufgaben verringert das Risiko manueller Fehler und ermöglicht eine bessere Protokollierung von Aktionen. Zu den häufigen Aufgaben, bei denen RealmJoin Ihnen bei der Automatisierung helfen kann, gehören: * Benutzer-Lebenszyklusoperationen (Onboarding/Offboarding von Benutzern) * Erstellen von temporären Zugriffspässen (TAPs) * Berichterstellung über die Nutzung von M/O365-Lizenzen * 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 Migrationsprozess 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"-Erfahrung in Ihrem Automation-Konto aktiviert ist. {% endhint %}
Beim Ausführen eines [Syncs](#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 benötigte PowerShell-Module automatisch importiert. {% hint style="info" %} Aufgrund **unterschiedlicher Prozesslaufzeiten** die Fehler wie 404 verursachen könnten, führen Sie bitte **erneut einen Sync 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“ nutzen, um sie manuell zu migrieren. Stellen Sie sicher, dass Sie die Runbooks „veröffentlichen“, damit die Änderung wirksam wird. {% endhint %}
## Häufige Runbooks RealmJoin pflegt ein [gemeinsamen Online-Repository der Runbooks](https://github.com/realmjoin/realmjoin-runbooks). Sie zielen darauf ab, viele häufige Vorgänge abzudecken, 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, nichttechnische 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 auf „Sync runbooks with upstream“ bei ![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 [Namenskonvention](/de/automatisierung/runbooks/naming-conventions.md) werden dadurch Runbooks im verbundenen Azure Automation-Konto hinzugefügt, aktualisiert und, falls erforderlich, entfernt, damit sie mit dem gemeinsamen Repository von RealmJoin synchronisiert 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 Informationsbausteine wie Bürostandorte verwenden * 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)für weitere Details. ## Bereiche Runbooks im RealmJoin Portal sind auf die verschiedenen Objekttypen in Ihrer Umgebung beschränkt. Einige Runbooks arbeiten auf Tenant-/Organisationsebene, z. B. beim Erstellen eines Lizenzberichts. Einige Runbooks sind pro Benutzer ausgelegt, z. B. beim Zurücksetzen eines Passworts. RealmJoin Portal verwendet diese Zuordnung, um die richtigen Runbooks im richtigen Kontext anzubieten. Siehe [Benennungskonventionen](/de/automatisierung/runbooks/naming-conventions.md) um zu erfahren, wie Runbooks bestimmten Objekten in Ihrer Umgebung zugeordnet werden. ## Zugriffskontrolle Der Zugriff / die Berechtigungen zur Nutzung bestimmter Runbooks können granular auf Runbook-Ebene vergeben werden. Beispielsweise könnten Runbook-Berechtigungen Ihnen helfen: * Den Zugriff auf dieses Runbook nur Operatoren der 3. Ebene erlauben * Nur unserem VIP-Supportteam erlauben, die E-Mail-Adresse des CEOs 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=&goal= ``` `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.