> 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

Führen Sie RealmJoin Runbooks auf einem Hybrid Runbook Worker aus, damit sie lokale und Ressourcen in privaten Netzwerken erreichen können, die die Azure-Cloud nicht erreichen kann.

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 keinen Einblick in Ihr **lokales** oder anderweitig privates Netzwerk.

Eine **Hybrid Runbook Worker** löst dieses Problem. Es ist ein Computer, den Sie in Ihrer eigenen Umgebung betreiben (zum Beispiel vor Ort oder in einem privaten Cloud-Netzwerk) und mit Ihrem Azure Automation-Konto registrieren. Runbooks, die auf diesen Worker abzielen, werden **auf diesem Computer innerhalb Ihres Netzwerks**ausgeführt, während sie weiterhin über RealmJoin wie jedes andere Runbook gestartet, nachverfolgt und auditiert werden.

## Warum Sie es verwenden könnten

Verwenden Sie einen Hybrid Runbook Worker immer dann, wenn ein Runbook auf etwas zugreifen muss, das die Azure-Cloud nicht erreichen kann:

* Vor Ort **Active Directory**, Datei-Server oder Druckserver
* Geschäftsanwendungen und Datenbanken, die in Ihrem eigenen Rechenzentrum gehostet werden
* Netzwerkgeräte, Appliances oder interne APIs, die nicht dem Internet ausgesetzt sind
* Jede Ressource, auf die aus Sicherheits- oder Konnektivitätsgründen von innerhalb Ihres Unternehmensnetzwerks zugegriffen werden muss

Sie behalten den Komfort von RealmJoins Runbook-Erlebnis (Self-Service, Berechtigungen, Genehmigungen, Protokollierung), während die eigentliche Arbeit dort ausgeführt wird, wo sich Ihre Ressourcen befinden.

## 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 ausgeführt wird und mit Ihren internen Ressourcen kommunizieren kann.
* **Welche Runbooks hybrid sind.** RealmJoin erkennt ein Runbook als „hybrid“ an seinem Namen: Runbooks, deren Name auf **`_hybrid`** endet, werden an Ihre Hybrid Worker Group 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 Group** die Sie konfiguriert haben. Eine Worker Group kann ein oder mehrere Computer enthalten; Azure Automation wählt einen verfügbaren Worker in dieser Gruppe für die Aufgabe aus.

{% 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 ein oder mehrere Computer bereit und registrieren Sie sie als **Hybrid Runbook Worker Group** in Ihrem Azure Automation-Konto. Siehe 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 Computer Netzwerkzugriff auf die lokalen oder privaten Ressourcen haben, die Ihre Runbooks benötigen.

{% hint style="warning" %}
Wenn in Ihrem Automation-Konto keine Hybrid Runbook Worker Group 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

Im RealmJoin-Portal gehen Sie 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-Synchronisierung einschalten

Aktivieren **Hybride Runbook Worker-Synchronisierung aktivieren**. RealmJoin liest die in Ihrem Azure Automation-Konto registrierten Hybrid Worker Groups aus.
{% endstep %}

{% step %}

### Wählen Sie eine Hybrid Worker Group

Wählen Sie die **Hybrid Worker Group** aus, 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 bei jedem anderen Runbook — Ihr Support- und Administrationsteam muss nichts Besonderes tun.

* Wenn ein Runbook an einen Hybrid Runbook Worker weitergeleitet wird, zeigt der Ausführungsdialog einen Hinweis wie *„Wird auf 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 Group zur Auswahl konfiguriert ist, kann der Anwender **auswählen, welche Hybrid Runbook Worker Group** beim Start verwendet werden soll.
* Runbooks, die [Genehmigung](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-permissions.md) erfordern, behalten die ausgewählte Worker Group 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](https://docs.realmjoin.com/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/de/automatisierung/runbooks/hybrid-runbook-worker.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
