> 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/hybrid-runbook-worker.md). # Hybrid Runbook Worker {% hint style="warning" %} Diese Funktion ist derzeit nur verfügbar auf [portal-staging.realmjoin.com](https://portal-staging.realmjoin.com). {% endhint %} Standardmäßig laufen RealmJoin Runbooks in Microsofts **Azure Automation-Cloud**. Das ist perfekt für Aufgaben gegen Clouddienste (Entra ID, Intune, Exchange Online, …), aber die Cloud hat keine Sichtverbindung in Ihr **vor Ort** oder anderweitig privates Netzwerk. Ein **Hybrid Runbook Worker** löst das. Es ist ein Computer, den Sie in Ihrer eigenen Umgebung betreiben (zum Beispiel vor Ort oder in einem privaten Cloud-Netzwerk) und bei Ihrem Azure Automation-Konto registrieren. Runbooks, die auf diesen Worker abzielen, werden **auf diesem Computer innerhalb Ihres Netzwerks ausgeführt**, während sie weiterhin wie jedes andere Runbook über RealmJoin gestartet, nachverfolgt und geprüft werden. ## Warum Sie es verwenden könnten Verwenden Sie einen Hybrid Runbook Worker immer dann, wenn ein Runbook etwas erreichen muss, das die Azure-Cloud nicht kann: * Vor Ort **Active Directory**, Dateiserver oder Druckserver * Fachanwendungen und Datenbanken, die in Ihrem eigenen Rechenzentrum gehostet werden * Netzwerkgeräte, Appliances oder interne APIs, die nicht im Internet verfügbar sind * Jede Ressource, auf die aus Ihrem Unternehmensnetzwerk aus Sicherheits- oder Verbindungsgründen zugegriffen werden muss Sie behalten den Komfort der Runbook-Erfahrung von RealmJoin (Self-Service, Berechtigungen, Genehmigungen, Protokollierung), während die eigentliche Arbeit dort stattfindet, wo Ihre Ressourcen liegen. ## So funktioniert es * **Wo es ausgeführt wird.** Ein normales Runbook läuft in der Azure-Cloud-Sandbox. Ein hybrides Runbook wird stattdessen an Ihren Hybrid Runbook Worker übergeben, sodass es auf Ihrem eigenen Computer läuft und mit Ihren internen Ressourcen kommunizieren kann. * **Welche Runbooks hybrid sind.** RealmJoin erkennt ein Runbook anhand seines Namens als „hybrid“: Runbooks, deren Name mit **`_hybrid`** endet, werden an Ihre Hybrid Worker-Gruppe weitergeleitet. Alle anderen Runbooks laufen weiterhin wie bisher in der Cloud. * **Wo es genauer ausgeführt wird.** Wenn ein hybrides Runbook startet, sendet RealmJoin es an die **Hybrid Worker-Gruppe** die Sie konfiguriert haben. Eine Worker-Gruppe kann eine oder mehrere Maschinen enthalten; Azure Automation wählt einen verfügbaren Worker in dieser Gruppe aus, um die Arbeit zu erledigen. {% hint style="info" %} Das Aktivieren dieser Funktion **nicht** verschiebt Ihre vorhandenen Runbooks nicht aus der Cloud. Nur Runbooks mit dem `_hybrid` Suffix werden an den Hybrid Runbook Worker weitergeleitet. {% endhint %} ## Voraussetzungen Bevor Sie die Funktion in RealmJoin aktivieren können, benötigen Sie einen funktionsfähigen Hybrid Runbook Worker in Ihrem Azure Automation-Konto: 1. Stellen Sie eine oder mehrere Maschinen bereit und registrieren Sie sie als **Hybrid Runbook Worker-Gruppe** in Ihrem Azure Automation-Konto. Die Einrichtungsschritte finden Sie in Microsofts Anleitung zu [Hybrid Runbook Workers](https://learn.microsoft.com/en-us/azure/automation/automation-hybrid-runbook-worker) für die Einrichtungsschritte. 2. Stellen Sie sicher, dass diese Maschinen Netzwerkzugriff auf die On-Premises- oder privaten Ressourcen haben, die Ihre Runbooks benötigen. {% hint style="warning" %} Wenn in Ihrem Automation-Konto keine Hybrid Runbook Worker-Gruppe vorhanden ist, kann RealmJoin keine zur Auswahl anbieten und fordert Sie auf, zuerst einen Worker zu registrieren. {% endhint %} ## Aktivieren in RealmJoin {% stepper %} {% step %} ### Öffnen Sie Ihre Runbook-Einstellungen Gehen Sie im RealmJoin Portal zu Ihren Runbook-Einstellungen. Die Option für den Hybrid Runbook Worker wird verfügbar, sobald Ihre erste Runbook-Konfiguration gespeichert wurde. {% endstep %} {% step %} ### Hybrid Runbook Worker-Sync aktivieren Aktivieren **Hybrid Runbook Worker-Sync aktivieren**. RealmJoin liest die in Ihrem Azure Automation-Konto registrierten Hybrid Worker-Gruppen aus. {% endstep %} {% step %} ### Wählen Sie eine Hybrid Worker-Gruppe aus Wählen Sie das **Hybrid Worker-Gruppe** auf der Ihre hybriden Runbooks ausgeführt werden sollen, und speichern Sie dann. Dies wird zum Standardziel für alle `_hybrid` Runbooks in Ihrem Tenant. {% endstep %} {% endstepper %} ## Ein hybrides Runbook ausführen Das Ausführen eines hybriden Runbooks funktioniert genau wie jedes andere Runbook — Ihr Support- und Verwaltungspersonal muss nichts Besonderes tun. * Wenn ein Runbook an einen Hybrid Runbook Worker weitergeleitet wird, zeigt der Ausführungsdialog einen Hinweis wie *„Wird in der Hybrid Runbook Worker-Gruppe ausgeführt: …“* an, sodass klar ist, wo die Aufgabe ausgeführt wird. * Wenn ein Runbook mit mehr als einer Worker-Gruppe zur Auswahl konfiguriert ist, kann der Bediener **auswählen, welche Hybrid Runbook Worker-Gruppe** beim Start verwendet werden soll. * Runbooks, die eine [Genehmigung](/de/automatisierung/runbooks/runbook-permissions.md) erfordern, behalten die ausgewählte Worker-Gruppe bei, sodass die Aufgabe nach der Genehmigung auf dem vorgesehenen Worker ausgeführt wird. {% hint style="info" %} Runbook-Protokolle und Auftragsdetails sind wie gewohnt im RealmJoin Portal verfügbar — siehe [Runbook-Protokolle](/de/automatisierung/runbooks/runbook-logs.md) — unabhängig davon, ob ein Runbook in der Cloud oder auf einem Hybrid Runbook Worker ausgeführt wurde. {% endhint %} --- # 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/hybrid-runbook-worker.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.