> 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/bereitstellung/onboarding-realmjoin-portal/advanced-setup.md).

# Erweiterte Einrichtung

Mit der erweiterten Einrichtung können Sie Berechtigungen feiner granuliert und individueller zuweisen. Dieser Ansatz ist flexibler, aber komplexer und erfordert die Ausführung des RealmJoin-PowerShell-Moduls.

Das RealmJoin PowerShell-Modul automatisiert die Einrichtung Ihres RealmJoin-Tenant. Es:

* Erstellt die erforderlichen Microsoft Entra ID-Dienstprinzipale für die RealmJoin-Anwendungen
* Weist die passenden Microsoft Graph-Berechtigungen basierend auf den von Ihnen ausgewählten Features zu
* Konfiguriert RealmJoin-Features (Portal, Intune LAPS, Autopilot, Geräteaktionen, Remediation-Skripts, Sicherheitsfeatures)
* Bereinigt veraltete Anwendungen aus früheren Konfigurationen

Das Modul wird auf dem [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin).

## Voraussetzungen

{% hint style="info" %}
Die erforderlichen Azure PowerShell-Module (`Az.Accounts`, `Az.Resources`, `Az.Automation`) werden beim ersten Ausführen eines Befehls für den aktuellen Benutzer automatisch in den vom Modul festgelegten Versionen installiert.
{% endhint %}

* **PowerShell 5.1** oder höher (Windows PowerShell oder PowerShell 7)
* Ein Konto, das **Dienstprinzipale erstellen und Anwendungsberechtigungen gewähren kann** in Microsoft Entra ID — zum Beispiel *Global Administrator* oder *Privileged Role Administrator*
* Die Anmeldung erfolgt über `Connect-AzAccount`, das die **Azure PowerShell** Erstanbieteranwendung. Tenants, die die Benutzereinwilligung einschränken, benötigen möglicherweise zuerst einen Administrator, der dieser Anwendung die Administratoreinwilligung erteilt.
* Zugriff auf die [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) um das Modul zu installieren

Ein Azure-Abonnement wird nur für die Azure-Ressourcen benötigt (`Set-RJLogAnalyticsWorkspace`, `Set-RJAutomationAccount`). `New-RJTenant` und `Update-RJTenant` in einem Tenant ohne Abonnement arbeiten; melden Sie sich dafür mit `Connect-AzAccount -Tenant <tenant-id>` zuerst an.

## Empfohlene Einrichtung

Der im RealmJoin Portal angezeigte Einrichtungsbefehl führt `Complete-RJTenantOnboarding` (Alias von `Update-RJTenant`) ohne Feature-Auswahl aus. Er weist die Berechtigungen der obligatorischen Funktion und aller Standardfunktionen zu:

* Kernfunktionalität des Portals (`RealmJoinPortal`, obligatorisch)
* Intune LAPS (`IntuneLAPS`)
* Anmeldedaten (`ShowSignin`)
* Autopilot (`Autopilot`)
* Intune-Geräteaktionen (`DeviceIntuneActions`)
* Remediation-Skripts (`DeviceHealthScript`)
* BitLocker-Wiederherstellungsschlüssel (`BitLockerRecoveryKeys`)
* Enrollment für Windows-Geräteupdates (`WindowsDeviceUpdateEnrollment`)

Bereits im Tenant konfigurierte Features, zum Beispiel `SecurityFeatures` oder `Client`, bleiben erhalten. Um alle Features oder einzelne Features hinzuzufügen, siehe [Weitere Befehle](#other-commands).

{% stepper %}
{% step %}

#### PowerShell unter Windows/Mac öffnen

Wir empfehlen, das RealmJoin PowerShell-Modul in einer **frisch geöffnete** PowerShell-Sitzung auf Ihrem eigenen Gerät statt in Azure Cloud Shell zu installieren und auszuführen. Das Modul erfordert für jedes `Az.*` Modul (`Az.Accounts` 5.5.x, `Az.Resources` 10.2.x, `Az.Automation` 1.12.x); wenn in der Sitzung bereits eine andere Version geladen ist — was in Cloud Shell typischerweise der Fall ist — wird mit einem Versionskonflikt abgebrochen, der sich nur durch das Öffnen einer neuen Sitzung beheben lässt.

Eine erhöhte ("Als Administrator ausführen")-Sitzung ist nicht erforderlich: Module werden mit `-Scope CurrentUser`.
{% endstep %}

{% step %}

#### Das RealmJoin-Onboarding-Skript kopieren und ausführen

Das Skript fordert Sie auf, sich bei Azure anzumelden. Verwenden Sie ein Konto, das Dienstprinzipale erstellen und Anwendungsberechtigungen gewähren kann, zum Beispiel Ihren Global Administrator.

Das Token im Befehl verknüpft die Ausführung mit Ihrem Tenant im RealmJoin Portal. Es ist eine Stunde lang gültig; wenn es abgelaufen ist, öffnen Sie die Seite „Erweiterte Einrichtung“ im Portal erneut, um einen Befehl mit einem neuen Token zu erhalten.

```powershell
Install-Module -Force -Name RealmJoin
Complete-RJTenantOnboarding -Token 1234ABCD 6>&1
```

{% hint style="info" %}
**Über `6>&1`:** Diese Befehle schreiben ihre Fortschrittsaktualisierungen in PowerShells Informationsstrom. Die `6>&1` Umleitung zeigt diese Ausgabe in der Konsole an — ohne sie sehen Sie während der Ausführung keine detaillierten Fortschrittsmeldungen.
{% endhint %}

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FdxYM2mTZ5LNcJhgudknf%2FSnipaste_2026-01-27_12-00-54.png?alt=media&amp;token=1fa4cd4e-485a-43e4-8a90-f6e6f6f57cb5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Beginnen Sie mit der Nutzung von RealmJoin

Nachdem die Berechtigungen zugewiesen wurden, sendet der Befehl das Token an die RealmJoin API. Die Seite „Erweiterte Einrichtung“ im Portal prüft regelmäßig, ob das Token verwendet wurde, und leitet Sie dann zum Portal weiter. Lassen Sie die Seite geöffnet, während der Befehl ausgeführt wird.

Wenn der Service Principal des RealmJoin Portals zuvor im Tenant nicht vorhanden war, öffnet der Befehl das RealmJoin Portal außerdem in Ihrem Browser.

{% 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 %}
{% endstepper %}

## Weitere Befehle

### Interaktive Einrichtung

Für eine geführte, menügesteuerte Erfahrung zur Tenant-Einrichtung, zu Konfigurationsänderungen, dem Log Analytics Workspace und dem Automation Account:

```powershell
Show-RJInteractiveSetup
```

Um die verfügbaren Features vor jeder Konfiguration zu überprüfen:

```powershell
Show-RJFeatureInfo
```

### Benutzerdefinierte Konfiguration

`New-RJTenant` konfiguriert einen Tenant mit genau den ausgewählten Features. Verwenden Sie es für Tenants, die noch nicht konfiguriert sind.

{% hint style="warning" %}
In einem bereits konfigurierten Tenant, `New-RJTenant` entfernt die Berechtigungen aller konfigurierten Features, die nicht Teil der Auswahl sind, und löscht Dienstprinzipale, die ohne Berechtigungen zurückbleiben. Zum Beispiel, `New-RJTenant` ohne Parameter entfernt `SecurityFeatures` und `Client`. Um eine vorhandene Konfiguration zu ändern, verwenden Sie [`Update-RJTenant`](#updating-existing-configuration).
{% endhint %}

#### Standard-Features

Aktiviert die obligatorische Kernfunktionalität des Portals plus die standardmäßigen optionalen Features (alle außer `Client`, `SecurityFeatures` und `AndroidApps`):

```powershell
New-RJTenant 6>&1
```

#### Minimale Features (nur obligatorische Features)

```powershell
New-RJTenant -Features @('RealmJoinPortal') 6>&1
```

#### Voller Funktionsumfang

```powershell
New-RJTenant -All 6>&1
```

#### Schreibgeschützte Berechtigungen

Weist, sofern verfügbar, schreibgeschützte Berechtigungen zu (zum Beispiel, `Group.ReadWrite.All` wird `Group.Read.All`):

```powershell
New-RJTenant -ReadOnly 6>&1
```

Für drei Features gibt es keine schreibgeschützte Variante; sie behalten ihre Berechtigungen mit `-ReadOnly`:

| Feature                         | Berechtigung                                              |
| ------------------------------- | --------------------------------------------------------- |
| `DeviceIntuneActions`           | `DeviceManagementManagedDevices.PrivilegedOperations.All` |
| `WindowsDeviceUpdateEnrollment` | `WindowsUpdates.ReadWrite.All`                            |
| `AndroidApps`                   | `DeviceManagementConfiguration.ReadWrite.All`             |

Lassen Sie für eine Konfiguration ohne Schreibberechtigungen diese Features weg:

```powershell
New-RJTenant -Features @('IntuneLAPS', 'ShowSignin', 'Autopilot', 'DeviceHealthScript', 'BitLockerRecoveryKeys') -ReadOnly 6>&1
```

#### Benutzerdefinierte Feature-Auswahl

```powershell
New-RJTenant -Features @('RealmJoinPortal', 'IntuneLAPS', 'Autopilot') 6>&1
```

### Vorhandene Konfiguration aktualisieren

`Update-RJTenant` passt einen bereits konfigurierten Tenant an. Der Alias `Complete-RJTenantOnboarding` kann austauschbar mit `Update-RJTenant`.

* Ohne `-Features`, `-All`, `-AddFeatures` oder `-RemoveFeatures`, bleiben die bereits im Tenant konfigurierten Features erhalten und die Standard-Features werden hinzugefügt. Es wird nichts entfernt.
* `-Features` ersetzt die Konfiguration: konfigurierte Features, die nicht in der Liste stehen, werden entfernt, einschließlich ihres Service Principal. Eine leere Liste wird abgelehnt.
* `-AddFeatures` und `-RemoveFeatures` ändern nur die genannten Features.
* Jede Ausführung entfernt außerdem veraltete RealmJoin-Anwendungen aus dem Tenant, siehe [Von der Schnell-Einrichtung wechseln](#switching-from-quick-setup).

#### Neue Features hinzufügen

```powershell
Update-RJTenant -AddFeatures @('SecurityFeatures') 6>&1
```

#### Features entfernen

```powershell
Update-RJTenant -RemoveFeatures @('ShowSignin') 6>&1
```

#### Zu schreibgeschützten Berechtigungen wechseln

Schaltet die konfigurierten Features und die Standard-Features auf ihre schreibgeschützten Berechtigungen um. Die unter [Schreibgeschützte Berechtigungen](#read-only-permissions) behalten ihre Schreibberechtigungen.

```powershell
Update-RJTenant -ReadOnly 6>&1
```

Zusammen mit `-AddFeatures`, `-ReadOnly` gilt nur für die hinzugefügten Features; die Berechtigungen der bereits konfigurierten Features bleiben unverändert.

#### Änderungen in der Vorschau anzeigen

```powershell
Update-RJTenant -AddFeatures @('SecurityFeatures') -WhatIf 6>&1
```

### Azure-Ressourcen

Das Modul stellt außerdem die begleitenden Azure-Ressourcen bereit, die RealmJoin verwendet. Diese sind keine Graph-Berechtigungs-Features und werden nicht mit `-Features`:

* `Set-RJLogAnalyticsWorkspace` — stellt den Log Analytics Workspace mit seinen benutzerdefinierten Tabellen und Datenerfassungsregeln bereit, siehe [Verbindung mit Azure Log Analytics Workspace](https://docs.realmjoin.com/de/uberwachung-and-protokolle/log-analytics.md)
* `Set-RJAutomationAccount` — stellt den RealmJoin Automation Account mit einer verwalteten Identität und den benötigten Berechtigungen bereit, siehe [Verbindung mit Azure Automation](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation.md)

Beide Befehle werden mit den passenden Parametern und einem Onboarding-Token auf der jeweiligen Einstellungsseite im RealmJoin Portal generiert.

## Verfügbare Features

Verwenden Sie diese Feature-Namen mit den `-Features`, `-AddFeatures`, und `-RemoveFeatures` Parametern. Obligatorische Features sind immer aktiviert. Die Standardkonfiguration (`New-RJTenant` ohne Parameter) aktiviert die unten markierten Features; **SecurityFeatures**, **Client** und **AndroidApps** müssen explizit ausgewählt werden.

| Feature                         | Beschreibung                                                                                                                                                                                                | Standard |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------: |
| `RealmJoinPortal`               | Kernfunktionalität des Portals für Self-Service der Benutzer und die Interaktion mit Administratoren (obligatorisch)                                                                                        |    ☑️    |
| `IntuneLAPS`                    | Lokale Administratorpasswörter über Intune LAPS abrufen und verwalten                                                                                                                                       |    ☑️    |
| `ShowSignin`                    | Anmeldehistorie und Protokolle der Benutzer anzeigen                                                                                                                                                        |    ☑️    |
| `Autopilot`                     | Windows Autopilot-Bereitstellungsprofile und -Status anzeigen                                                                                                                                               |    ☑️    |
| `DeviceIntuneActions`           | Privilegierte Geräteaktionen ausführen (Synchronisieren, Neustarten, Löschen usw.)                                                                                                                          |    ☑️    |
| `DeviceHealthScript`            | PowerShell-Remediation-Skripts auf Geräten verwalten und bereitstellen                                                                                                                                      |    ☑️    |
| `BitLockerRecoveryKeys`         | BitLocker-Wiederherstellungsschlüssel für verwaltete Geräte anzeigen                                                                                                                                        |    ☑️    |
| `WindowsDeviceUpdateEnrollment` | Enrollment für Windows-Geräteupdates verwalten                                                                                                                                                              |    ☑️    |
| `SecurityFeatures`              | [Integration mit Defender for Endpoint](https://docs.realmjoin.com/de/ugd-management/defender-integration.md) auf Geräteseiten (erfordert MDE-Lizenzen)                                                     |          |
| `Client`                        | RealmJoin Agent — Clientanwendung für die Geräteverwaltung                                                                                                                                                  |          |
| `AndroidApps`                   | [Bereitstellung von Android-Apps](https://docs.realmjoin.com/de/anwendungsverwaltung/packages/android-apps-managed-google-play.md) über Managed Google Play (`DeviceManagementConfiguration.ReadWrite.All`) |          |

## Von der Schnell-Einrichtung wechseln

Ein mit Quick Setup angebundener Tenant verwendet die **RealmJoin Portal - Core Features** App-Registrierung, die alle Portalberechtigungen enthält. Um sie zu Advanced Setup zu verschieben, gehen Sie zu **Organisation → Features** im RealmJoin Portal und wählen Sie **Zu erweitertem Modus wechseln** auf der **Erweiterten Einrichtung** Karte an. Das Portal zeigt dann den Onboarding-Befehl mit einem Token an, wie unter [Empfohlene Einrichtung](#recommended-setup).

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-90feb65a312dda59e5e23473be499c34566c8b1c%2Forganization-features-advanced-setup-switch.png?alt=media" alt="Advanced setup card on the Organization Features page"><figcaption><p>Karte „Erweiterte Einrichtung“ für Tenants mit Quick Setup</p></figcaption></figure>

Wenn der Befehl ausgeführt wird, erstellt das Modul die Dienstprinzipale für die ausgewählten Features und entfernt die **RealmJoin Portal - Core Features** App-Registrierung als veraltete Anwendung. Sobald die neuen Berechtigungen vorhanden sind, schaltet das Portal den Tenant auf Advanced Setup um.

{% hint style="warning" %}
Der Wechsel ist nur in eine Richtung möglich. Nachdem die App-Registrierung der Core Features entfernt wurde, werden Berechtigungen nur noch mit dem RealmJoin PowerShell-Modul verwaltet.
{% endhint %}

## Fehlerbehebung

{% hint style="warning" %}
**"Unzureichende Berechtigungen"** — das Erstellen von Dienstprinzipalen und das Gewähren von Anwendungsberechtigungen erfordert ein entsprechend berechtigtes Konto, zum Beispiel *Global Administrator* oder *Privileged Role Administrator*. Siehe [Voraussetzungen](#prerequisites).
{% endhint %}

{% hint style="warning" %}
**"Adminfreigabe erforderlich" oder ein Zustimmungsfehler während der Anmeldung** — die Anmeldung verwendet die **Azure PowerShell** First-Party-Anwendung. Wenn Ihr Tenant die Benutzerzustimmung einschränkt, muss ein Administrator dieser Anwendung einmal die Administratorzustimmung erteilen.
{% endhint %}

{% hint style="warning" %}
**"RealmJoin-Modul ist veraltet - Ausführung kann nicht fortgesetzt werden"** — jeder Befehl prüft einmal pro Sitzung, ob Sie die aktuell veröffentlichte Version verwenden. Installieren Sie die aktuelle Version, schließen Sie dann die Sitzung und öffnen Sie eine neue:

```powershell
Install-Module -Name RealmJoin -Force -Scope CurrentUser
```

{% endhint %}

{% hint style="warning" %}
**"Authentifizierung fehlgeschlagen (401). Das Token ist möglicherweise ungültig oder abgelaufen."** — die Berechtigungen wurden zugewiesen, aber der Tenant konnte nicht bei RealmJoin registriert werden, weil das Onboarding-Token abgelaufen ist (nach einer Stunde) oder ungültig ist. Öffnen Sie die Seite „Erweiterte Einrichtung“ im RealmJoin Portal erneut und führen Sie den Befehl mit dem neuen Token aus. Eine erneute Ausführung ändert bereits vorhandene Berechtigungen nicht.
{% endhint %}

{% hint style="warning" %}
**Ein Versionskonflikt eines Moduls wird gemeldet** — ein `Az.*` Modul in einer anderen Version als der vom Modul festgelegten Version ist bereits geladen. Dies kann in der laufenden Sitzung nicht behoben werden: Schließen Sie PowerShell, öffnen Sie eine neue Sitzung und führen Sie den Befehl erneut aus.
{% endhint %}

Wenn das Modul nicht gefunden werden kann, vergewissern Sie sich, dass die PowerShell Gallery verfügbar ist, und installieren Sie es erneut:

```powershell
Get-PSRepository
Install-Module -Name RealmJoin -Force -Scope CurrentUser
```

### Hilfe erhalten

```powershell
Get-Help New-RJTenant -Full
Get-Help Update-RJTenant -Examples
Get-Help Show-RJInteractiveSetup -Detailed
```


---

# 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/bereitstellung/onboarding-realmjoin-portal/advanced-setup.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.
