> 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/connecting-azure-automation.md).

# Verbinden von Azure Automation

Verbinden Sie ein Azure Automation-Konto mit dem RealmJoin-Portal über das RealmJoin-PowerShell-Modul, damit RealmJoin Runbooks in Ihrem Tenant bereitstellen, ausführen und überwachen kann.

## Übersicht

Um RealmJoin Portal die Bereitstellung von [Runbooks](https://docs.realmjoin.com/de/automatisierung/runbooks.md) für die Automatisierung täglicher Aufgaben musst du ein [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) Konto verbinden. Es dient als Host für deine Runbooks und stellt die [Berechtigungen](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation/azure-ad-roles-and-permissions.md) bereit, die die Runbooks benötigen, um in deiner Umgebung zu funktionieren.

Das Automation-Konto wird mit der [RealmJoin PowerShell-Modul](https://docs.realmjoin.com/de/bereitstellung/onboarding-realmjoin-portal/advanced-setup.md). Das Portal generiert für dich einen sofort kopierbaren Befehl — es gibt keine App-Registrierung zu erstellen und kein Clientgeheimnis zu verwalten.

{% hint style="info" %}
Sind Runbooks für deinen Tenant bereits mit der älteren **RealmJoin Runbook Management** App-Registrierung konfiguriert? Dann siehe [Wechseln zur von RealmJoin verwalteten App](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation/managed-app-migration.md). Es behält dein Automation-Konto und deine Runbooks bei und entfernt das tenantbezogene Clientgeheimnis.
{% endhint %}

## Überlegungen

Die [Verwaltete Identität](https://learn.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/overview) erfordert umfangreiche [Berechtigungen](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation/azure-ad-roles-and-permissions.md) Berechtigungen in deiner Umgebung, etwa die Möglichkeit, Gruppen- oder Benutzerobjekte in Entra ID zu ändern oder Postfächer in Exchange Online zu verwalten. Beschränke den administrativen Zugriff auf dieses Konto, um Missbrauch dieser Berechtigungen zu verhindern.

Wenn du ein vorhandenes Automation-Konto verwendest, beachte, dass RealmJoin Portal automatisch Runbooks erstellt, aktualisiert und entfernt, die aus dem [gemeinsam genutzten Online-Repository für Runbooks](https://github.com/realmjoin/realmjoin-runbooks). Diese Funktionalität wird in einem vorhandenen Automation-Konto möglicherweise nicht unterstützt. Wenn du unsicher bist, empfehlen wir, ein dediziertes Azure Automation-Konto für RealmJoin Runbooks zu erstellen — was der Setup-Befehl für dich übernimmt.

## Was das Setup bereitstellt

Das Ausführen des Setup-Befehls erstellt:

* Die **RealmJoin Azure Resources** Service Principal in Ihrem Entra ID-Tenant (falls er noch nicht existiert)
* Ein **Automation-Konto** mit einer systemzugewiesenen verwalteten Identität, in der Region der Ressourcengruppe — oder dein vorhandenes Automation-Konto, wenn du eines angibst
* **Contributor** für den Service Principal von RealmJoin, auf dieses Automation-Konto beschränkt, damit RealmJoin Runbooks synchronisieren und starten kann
* Die **Anwendungsberechtigungen** für die verwaltete Identität, die das Modul bündelt — Microsoft Graph, Office 365 Exchange Online, Windows Defender ATP und SharePoint Online

RealmJoin authentifiziert sich mit seiner eigenen mandantenübergreifenden Anwendung bei Azure. In deinem Tenant werden keine App-Registrierung und kein Clientgeheimnis erstellt, und RealmJoin erhält keine Berechtigung außerhalb dieses Automation-Kontos.

{% hint style="warning" %}
Die **Entra ID-Verzeichnisrollen** — Intune Administrator, Exchange Administrator, Benutzeradministrator und so weiter — werden **nicht** vom Setup-Befehl zugewiesen. Sie müssen dennoch separat vergeben werden, siehe [Zuweisen von Rollen und Berechtigungen](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation/azure-ad-roles-and-permissions.md#granting-roles-and-permissions). Ohne sie funktioniert ein großer Teil der gemeinsam genutzten Runbooks nicht.
{% endhint %}

## Voraussetzungen

### Im RealmJoin Portal

* Eine Rolle, die Zugriff auf den Bereich Einstellungen gewährt (`CanReadSettingsDetails`, siehe [Verfügbare Berechtigungen](https://docs.realmjoin.com/de/administration-and-einstellungen/permission/custom-roles/available-permissions.md)). Die Einstellungsseite generiert den Setup-Befehl einschließlich eines kurzlebigen Onboarding-Tokens.

### In Azure

* Ein Azure-Abonnement und ein **vorhandene Ressourcengruppe** zum Bereitstellen — das Modul erstellt die Ressourcengruppe nicht. Eine separate Ressourcengruppe für das Automation-Konto wird empfohlen.
* Optional ein vorhandenes Automation-Konto. Wenn du keines angibst, wird ein Konto für dich erstellt.

### Auf dem Computer, auf dem PowerShell läuft

* **PowerShell 5.1** oder höher (Windows PowerShell oder PowerShell 7)
* Zugriff auf die [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) zum Installieren des RealmJoin-Moduls
* Die `Az.Accounts`, `Az.Resources` und `Az.Automation` Module — das RealmJoin-Modul installiert sie automatisch in den fest vorgegebenen Versionen für den aktuellen Benutzer

### Berechtigungen des Kontos, mit dem Sie sich anmelden

* **Microsoft Entra ID:** Berechtigung, Service Principals zu erstellen **und Anwendungsberechtigungen zu gewähren** — das Setup weist der verwalteten Identität Graph-, Exchange-, Defender- und SharePoint-App-Rollen zu. In der Praxis bedeutet das *Global Administrator* oder *Administrator für privilegierte Rollen*.
* **Azure-Abonnement:** Berechtigung zur Bereitstellung in der Ressourcengruppe **und** um darin Rollenzuweisungen zu erstellen — zum Beispiel *Owner*, oder *Contributor* in Kombination mit *User Access Administrator* / *Role Based Access Control Administrator*.
* Die Anmeldung erfolgt über `Connect-AzAccount`, das die **Azure PowerShell** First-Party-Anwendung verwendet. Mandanten, die die Benutzerzustimmung einschränken, müssen dieser Anwendung möglicherweise zunächst die Administratorzustimmung erteilen.

{% hint style="warning" %}
Führen Sie den Befehl in einer **frisch geöffneten, lokalen** PowerShell-Sitzung und vermeiden Sie **Azure Cloud Shell**. Das RealmJoin-Modul erfordert exakte Versionen der `Az.*` Module. Wenn in der Sitzung bereits eine andere Version geladen ist — was in Cloud Shell typischerweise der Fall ist — beendet sich das Modul mit einem Versionskonflikt, der nur durch das Öffnen einer neuen Sitzung behoben werden kann.
{% endhint %}

## Einrichtung

{% stepper %}
{% step %}

#### Bereiten Sie die Ressourcengruppe vor

Erstelle oder wähle im Azure Portal die Ressourcengruppe aus, die das Automation-Konto aufnehmen soll. Notiere dir ihren Namen und die ID des Abonnements, in dem sie sich befindet.

Wenn Sie einen **vorhandenen** Automation-Konto, notiere dir ebenfalls seinen Namen.
{% endstep %}

{% step %}

#### Kopieren Sie den Befehl aus dem RealmJoin Portal

Wechsle im RealmJoin Portal zu **Einstellungen → Runbooks** (<https://portal.realmjoin.com/settings/runbooks-configuration>).

Die Seite weist darauf hin, dass die Runbook-Konfiguration über das RealmJoin PowerShell-Modul verwaltet wird, und zeigt einen Befehlsblock an. Verwende den **Kopieren** Schaltfläche, um ihn zu kopieren.

```powershell
$latest = [version](Find-Module RealmJoin -Repository PSGallery -ErrorAction Stop).Version
if (-not (Get-Module -ListAvailable RealmJoin | Where-Object Version -ge $latest)) {
    Install-Module RealmJoin -Force -AllowClobber -ErrorAction Stop
}
Import-Module RealmJoin -Force
Set-RJAutomationAccount -Token "<Token>" 6>&1
```

{% hint style="info" %}
**Über `6>&1`:** diese Befehle melden ihren Fortschritt über den Informationsstream von PowerShell. Die `6>&1` Umleitung zeigt diese Ausgabe in der Konsole an — ohne sie sehen Sie keine Fortschrittsmeldungen.
{% endhint %}
{% endstep %}

{% step %}

#### Fügen Sie die Zielparameter hinzu

`Set-RJAutomationAccount` muss wissen, wohin bereitgestellt werden soll. Ergänzen Sie die letzte Zeile, bevor Sie sie ausführen:

```powershell
Set-RJAutomationAccount -ResourceGroupName "rg-realmjoin" -SubscriptionId "<SubscriptionId>" -Token "<Token>" 6>&1
```

* `-ResourceGroupName` ist erforderlich. Wenn Sie es weglassen, fordert PowerShell Sie dazu auf.
* `-SubscriptionId` ist optional — ohne ihn wird das Abonnement Ihres aktuellen Azure-Kontexts verwendet, und Sie werden aufgefordert, eines auszuwählen, wenn mehrere verfügbar sind.
* `-AutomationAccountName` ist optional. Gib ihn an, um den Namen eines neuen Automation-Kontos festzulegen oder ein **vorhandenen** Konto zu verwenden; andernfalls wird ein neues mit einem generierten Namen erstellt.

{% hint style="warning" %}
Wenn du den Befehl auf ein vorhandenes Automation-Konto anwendest, setzt er auch die Einstellungen durch, die RealmJoin dort erwartet: eine systemzugewiesene verwaltete Identität, die Basic-SKU und öffentlichen Netzwerkzugriff. Prüfe, ob das deinen Anforderungen entspricht, bevor du ein Konto erneut verwendest.
{% endhint %}
{% endstep %}

{% step %}

#### Führen Sie den Befehl aus

Fügen Sie den Block in eine neue PowerShell-Sitzung ein und führen Sie ihn aus. Das Token ist ungefähr eine Stunde gültig — wenn es abgelaufen ist, laden Sie die Einstellungsseite neu und kopieren Sie den Befehl erneut.

Sie werden aufgefordert, sich mit `Connect-AzAccount`. Wenn Ihr Konto Zugriff auf mehrere Tenants oder Subscriptions hat, fordert das Modul Sie auf, eine auszuwählen.

Die Bereitstellung läuft in drei Schritten ab — Service Principal, Automation-Konto, Berechtigungen — und meldet jede Ressource, sobald sie erstellt wird. Ein einzelner Durchlauf dauert in der Regel einige Minuten.

{% hint style="info" %}
Möchten Sie zuerst sehen, was passieren würde? Hängen Sie `-WhatIf` für eine Azure Resource Manager What-If-Vorschau an. Beachten Sie, dass die Anmeldung und die Installation der `Az` Module trotzdem stattfinden, da die Vorschau beides benötigt.
{% endhint %}

{% hint style="info" %}
**Abmelden danach:** Die Azure-Anmeldung bleibt nach Abschluss des Befehls aktiv. Wenn Sie fertig sind, führen Sie `Disconnect-AzAccount` aus, um sich von der bestehenden Sitzung abzumelden.
{% endhint %}
{% endstep %}

{% step %}

#### Die Entra ID-Rollen der verwalteten Identität zuweisen

Das Setup gewährt der verwalteten Identität ihre Anwendungsberechtigungen, aber nicht ihre Entra ID-Verzeichnisrollen. Weise sie jetzt zu — siehe [Zuweisen von Rollen und Berechtigungen](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation/azure-ad-roles-and-permissions.md#granting-roles-and-permissions) für die aktuelle Liste und ein Skript, das dies erledigt.

Die Objekt-ID der verwalteten Identität wird im Azure Portal beim Automation-Konto unter Kontoeinstellungen > Identität angezeigt.

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F4ecZSM3NW9PWJJlaNmR4%2Fimage.png?alt=media&amp;token=e5d5b56b-50f3-4f35-a41b-7cb4230dd3f3" alt=""><figcaption><p>Verwaltete Identität des Automation-Kontos</p></figcaption></figure>
{% endstep %}

{% step %}

#### Im Portal überprüfen und die erste Synchronisierung starten

Gehen Sie zurück zu **Einstellungen → Runbooks** und wählen Sie **Aktualisieren**. RealmJoin übernimmt die neue Konfiguration und startet den initialen Runbook-Import. Lass die Seite geöffnet, bis die Synchronisierung abgeschlossen ist.

Abonnement, Ressourcengruppe, Name des Automation-Kontos und Speicherort werden jetzt unter **Azure-Verbindung** schreibgeschützt angezeigt — sie werden fortan vom PowerShell-Modul verwaltet.
{% endstep %}
{% endstepper %}

## Einstellungen, die du im Portal verwaltest

Zwei Einstellungen bleiben in **Einstellungen → Runbooks** nach dem Setup bearbeitbar:

* **Branch** — der Branch des [gemeinsam genutzten Runbook-Repositorys](https://github.com/realmjoin/realmjoin-runbooks) dem du folgen möchtest. Das Setup setzt dies auf `production`, was die richtige Wahl ist, sofern du keinen Grund hast, davon abzuweichen.
* **Hybride Runbook Worker-Synchronisierung aktivieren** und die zu verwendende Worker-Gruppe, siehe [Hybrid Runbook Worker](https://docs.realmjoin.com/de/automatisierung/runbooks/hybrid-runbook-worker.md). Die Gruppe muss im Automation-Konto registriert sein, bevor sie hier ausgewählt werden kann.

Das Speichern einer der beiden Optionen löst eine Runbook-Synchronisierung aus.

Wenn später Konfigurations- oder Berechtigungsprobleme auftreten, bringt die **Cmdlet anzeigen** Schaltfläche unter Azure-Verbindung den Befehl wieder zurück — ein erneutes Ausführen ist sicher und ergänzt nur das Fehlende.

## Älteres Setup (App-Registrierung pro Tenant)

{% hint style="warning" %}
Das folgende Setup erstellt eine **RealmJoin Runbook Management** App-Registrierung mit einem Clientgeheimnis in deinem Tenant. Es ist nur als Referenz für Tenants dokumentiert, die in der Vergangenheit auf diese Weise konfiguriert wurden. Verwende es nicht für neue Konfigurationen — folge dem [Einrichtung](#setup) oben, oder [bestehende Konfiguration auf die verwaltete App umstellen](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation/managed-app-migration.md).
{% endhint %}

<details>

<summary>Die Legacy-Einrichtung anzeigen</summary>

Auf diesem Pfad wurde das Automation-Konto manuell im Azure Portal erstellt, seine Berechtigungen wurden mit zwei externen Skripten zugewiesen, und RealmJoin authentifizierte sich mit einer App-Registrierung pro Tenant und einem Clientgeheimnis.

**Teil 1 — Ein Azure Automation-Konto erstellen**

1. Navigiere zu deinem [Azure Portal > Automation-Konten](https://portal.azure.com/#create/Microsoft.AutomationAccount) und erstelle ein neues Automation-Konto.
2. Wähle auf der Registerkarte Grundlagen dein Abonnement, deine Ressourcengruppe, den Namen des Automation-Kontos und die Region aus.
3. Stelle auf der Registerkarte Erweitert sicher, dass die systemzugewiesene verwaltete Identität aktiviert ist.
4. Wähle Überprüfen + Erstellen und erstelle dein Automation-Konto.
5. Wechsle zu der Ressourcengruppe, die das Automation-Konto enthält, und weise es auf der Registerkarte IAM als Mitwirkender zu.

![Erstellen des Automation-Kontos](https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FqjBLc2zH3XCCqfAViEsU%2Fimage.png?alt=media\&token=257816e0-eb8a-478c-973f-fb288324d8c8)

![Aktivieren der systemzugewiesenen verwalteten Identität](https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FM9N3OxNzrzQXFxSaKIpP%2Fimage.png?alt=media\&token=1e7c4d5b-d604-415b-89e0-4816a7f04a26)

**Teil 2 — Dem Automation-Konto Berechtigungen zuweisen**

Berechtigungen für verwaltete Identitäten können nicht über das Azure Portal vergeben werden. Die [approle-and-directoryrole-granter](https://github.com/Workplace-Foundation/approle-and-directoryrole-granter) Skripte weisen sowohl die App-Berechtigungen als auch die Entra ID-Rollen aus den JSON-Dateien zu, die im [Runbooks-Repository](https://github.com/realmjoin/realmjoin-runbooks/tree/production/docs/other/json):

```powershell
. .\GrantAppPermToEntApp.ps1 -enterpriseAppObjId "<ManagedIdentityObjectId>" -permissionsTemplate .\AllRealmJoinRunbooks_collected_permissions.json
. .\AssignAzureADRoleToEntApp.ps1 -objectId "<ManagedIdentityObjectId>" -rolesTemplate .\AllRealmJoinRunbooks_collected_rbacroles.json
```

**Teil 3 — Den Service Principal für RealmJoin erstellen**

Im Portal wurden unter Einstellungen > Runbooks zunächst die Tenant ID, Subscription ID und Ressourcengruppe eingegeben; anschließend zeigte die Seite einen auszuführenden Azure-CLI-Ausschnitt an, der die **RealmJoin Runbook Management** App-Registrierung mit Mitwirkendenrechten auf der Ressourcengruppe erstellte:

```
az provider register --namespace Microsoft.Automation
az ad sp create-for-rbac -n "RealmJoin Runbook Management" --role contributor --scopes /subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroup>
```

**Teil 4 — Den Assistenten abschließen**

Zurück im Portal wurden die `appId` und `Kennwort` aus dieser Ausgabe zusammen mit dem Namen des Automation-Kontos, dem Branch des gemeinsam genutzten Runbook-Repositorys (`production`) und dem Speicherort des Automation-Kontos eingegeben. Das Speichern startete den initialen Runbook-Import.

![Verbindung zum Automation-Konto im RealmJoin Portal](https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FA0X3M2c9d13pxVt87Pf8%2Fimage.png?alt=media\&token=8e2f2b18-c3b1-4704-8cc8-eb4d43297dd1)

</details>


---

# 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/connecting-azure-automation.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.
