> 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/realmjoin-agent/installation.md).

# Bereitstellung des Agents

Der RealmJoin Agent kann nahtlos mithilfe von Microsoft Intune bereitgestellt werden. In unserem Package Store steht ein sofort verwendbares Paket zur Verfügung, das den Einrichtungsprozess vereinfacht.\
Diese Anleitung beschreibt die empfohlene und unterstützte Methode zur Installation des RealmJoin Agent über Intune.

## Automatische Bereitstellung

### Microsoft Intune (intunewin)

{% hint style="success" %}
Empfohlen
{% endhint %}

RealmJoin integriert sich direkt in Ihren Microsoft Intune Tenant, indem der Agent als intunewin-Paket hinzugefügt und aktualisiert wird:

1. Öffnen Sie unseren **Paket-Store**.
2. Wählen Sie das Banner „RealmJoin Agent“ oder verwenden Sie diesen direkten Link: [RealmJoin Agent (Gerät)](https://portal.realmjoin.com/packagestore/45935/overview)<br>

   <figure><img src="/files/4c52e97f15a69f4810728f2c9ae1002eeb8fa8b9" alt=""><figcaption></figcaption></figure>
3. Wählen Sie „**Intune verwenden (verwaltet)**“ als Bereitstellungsmethode aus und klicken Sie auf „Weiter“.
4. Fügen Sie dieses Paket Ihrer „**Enrollment Status Page**“ unter „Geräteverwendung blockieren, bis erforderliche Apps installiert sind, wenn sie dem Benutzer/Gerät zugewiesen sind“ hinzu. Dadurch wird sichergestellt, dass Intune während der Anmeldung mit der Installation des RealmJoin Agent wartet.
5. Bitte aktivieren Sie auch „**Automation Main channel**".

<figure><img src="/files/444fd9c902c0cf2d813469f287b94dab053b2e1a" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Der RealmJoin Agent wird **nach neueren Versionen suchen** während **der ersten Bereitstellung** und **bei Bedarf aktualisieren**. Um diesen Prozess zu beschleunigen, empfehlen wir weiterhin „Automate Main channel“. Dadurch wird sichergestellt, dass die aktuellste Version von Anfang an installiert ist.
{% endhint %}

{% hint style="warning" %}
Bitte **verwenden Sie nicht „Automate Preview channel“** da die **intunewin-Anwendungs-ID sich ändern kann** wodurch das Paket aus Ihrer „Enrollment Status Page“-Konfiguration entfernt wird.
{% endhint %}

6. **Weisen Sie** das Paket **Geräten** (wenn es Benutzerobjekten zugewiesen ist, startet der Agent möglicherweise nicht während der Bereitstellung), z. B.:
   1. Hinzufügen **einzelnen Geräten oder Gerätegruppe(n)** den automatisch erstellten verwalteten App-Gruppen
   2. Fügen Sie „**Alle Geräte**“ als **zusätzliche Zuweisung über Intune hinzu** (beachten Sie, dass Sie möglicherweise Filter benötigen, um spezielle Geräte wie AVD oder Kiosk auszuschließen)

{% hint style="info" %}
Unser Store bietet auch das Paket „RealmJoin Agent (Benutzer)“ an, das auf Benutzerebene läuft (was früher der Standard war). Aus Stabilitätsgründen empfehlen wir jetzt nur noch die Version auf Geräteebene. **Stabilitätsgründen**, empfehlen wir jetzt **nur noch die Version auf Geräteebene**.
{% endhint %}

## Beta- und Canary-Kanal

{% hint style="info" %}
Die RealmJoin Release **Kanal** kann **über Benutzer- und Gruppeneinstellungen angepasst werden**: [RealmJoin-Release-Kanal konfigurieren](/de/ugd-management/user-and-group-settings.md). Nur **während der ersten Bereitstellung**, wird der **Kanal vom Installer definiert und festgelegt** Paket. Bei Verwendung von [Automatische Bereitstellung](#automatic-deployment) mit unserem Package Store verwenden Bereitstellungen immer den Release-Kanal.
{% endhint %}

Für **um Erstbereitstellungen mit anderen Kanälen zu testen**, können Sie eine der folgenden intunewin-Pakete manuell herunterladen und hochladen:

* Beta-Kanal (nahe an stabil, für Langzeittests):\
  [RealmJoin Beta-Version](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)
* Canary-Kanal (experimentell, erstes Testen):\
  [RealmJoin Canary-Version](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)

Beim Hochladen in Intune verwenden Sie bitte die empfohlenen Einstellungen und:

* Programm:
  * Neustartverhalten des Geräts: `Verhalten anhand der Rückgabecodes bestimmen`
* Erkennungsregeln:
  * Erkennungsregeln manuell konfigurieren
  * Datei:
    * Pfad: `C:\Program Files\RealmJoin`
    * Datei oder Ordner: `RealmJoin.exe`
    * Erkennungsmethode: `Datei oder Ordner vorhanden`
    * Verknüpft mit einer 32-Bit-App auf 64-Bit-Clients: `Nein`

## Windows Defender-Ausnahmen

RealmJoin hat mit dem Microsoft Defender-Team zusammengearbeitet, um von der Malware-Erkennung auf die Whitelist gesetzt zu werden. Da Defender zunehmend Machine-Learning-Mechanismen verwendet, um potenzielle Bedrohungen zu identifizieren, und RealmJoin mehrere Funktionen wie aus der Cloud heruntergeladene Anwendungsinstallationen hat, könnte RealmJoin von **Windows Defender** als mögliche Bedrohung erkannt werden.

Auch wenn dieses Verhalten nicht sicher ist, wird empfohlen, zusätzliche **Windows Defender Antivirus-Ausnahmen**:

| Defender-Ausnahmen                              |
| ----------------------------------------------- |
| **Dateien und Ordner**                          |
| `%ProgramFiles%\RealmJoin`                      |
| `%ProgramFiles%\RealmJoin\RealmJoin.exe`        |
| `%ProgramFiles%\RealmJoin\RealmJoinService.exe` |
| `%ProgramFiles%\RealmJoin\RealmJoinUpdate.exe`  |
| **Prozesse**                                    |
| `%ProgramFiles%\RealmJoin`                      |
| `%ProgramFiles%\RealmJoin\RealmJoin.exe`        |
| `%ProgramFiles%\RealmJoin\RealmJoinService.exe` |
| `%ProgramFiles%\RealmJoin\RealmJoinUpdate.exe`  |

{% hint style="info" %}
Es ist wichtig, denselben Pfad in **Dateien und Ordner** und **Prozesse**zu konfigurieren. In einigen Fällen überprüft Microsoft nur eine dieser Defender-Ausnahmen.
{% endhint %}

## Zusätzliche Informationen

### Automatische Bereitstellung

#### Veraltet: Microsoft Intune (MSI)

{% hint style="warning" %}
Dieses **veraltete Bereitstellungsverfahren** wird nur zu Referenzzwecken bereitgestellt und wird **nicht mehr unterstützt**.

Beachten Sie auch, dass [Microsoft nicht empfiehlt, MSI- und intunewin-Bereitstellung zu mischen](https://learn.microsoft.com/en-us/intune/intune-service/apps/lob-apps-windows)„Wenn Sie während der Windows Autopilot-Anmeldung die Installation von Win32-Apps und Line-of-Business-Apps mischen, kann die App-Installation fehlschlagen, da beide gleichzeitig den Trusted Installer-Dienst verwenden.“
{% endhint %}

RealmJoin kann bereitgestellt werden über [MSI-Installer](#msi-installer) als Line-of-Business-App. Stellen Sie beim Hochladen in Intune sicher, dass „App-Version ignorieren“ auf „Ja“ gesetzt ist.

<figure><img src="/files/cc947c8bc6f1016db4ed3398485eb0c65fb71817" alt="" width="364"><figcaption></figcaption></figure>

### Interaktive Installation per Befehlszeile

Wenn ein Administrator den RealmJoin Agent auf einem Gerät ohne Massenbereitstellung oder die Microsoft Intune-Infrastruktur installieren möchte, kann er das MSI herunterladen und eine interaktive Installation durchführen. Alternativ können Sie auch eine der folgenden Befehlszeilen kopieren, um den Agenten in einem einzigen Schritt herunterzuladen und auszuführen.

#### MSI-Installer und EXE

* Stabile Version:\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.msi) oder [EXE](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe)
* Beta-Kanal (nahe an stabil, für Langzeittests):\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.msi) oder [EXE](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.exe)
* Canary-Kanal (experimentell, erstes Testen):\
  [MSI](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.msi) oder [EXE](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.exe)

#### Release-Kanal

```
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "((new-object net.webclient).DownloadFile('https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe', 'realmjoin.exe'))" && .\realmjoin.exe
```

#### Beta-Kanal

```
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "((new-object net.webclient).DownloadFile('https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.exe', 'realmjoin.exe'))" && .\realmjoin.exe
```

#### Canary-Kanal

```
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "((new-object net.webclient).DownloadFile('https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.exe', 'realmjoin.exe'))" && .\realmjoin.exe
```

### Stille Installation

Wenn Sie RealmJoin während einer unbeaufsichtigten Betriebssysteminstallation oder einer anderen nicht interaktiven Bereitstellungsmethode installieren, können Sie entscheiden, während der Installation keine Benutzeroberfläche anzuzeigen. Um RealmJoin in einem solchen Szenario zu installieren, verwenden Sie die Option für die stille Installation:

```
reamjoin.exe -install
```

### Signiertes MSI

Das RealmJoin.MSI ist von RealmJoin mit SHA2 (256 Bit) signiert und wird daher von Windows als sicher zu installierende Software erkannt.

![](/files/957f1e36f415490cf8ecee8189e9fc1566b542af)


---

# 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/realmjoin-agent/installation.md?ask=<question>&goal=<endgoal>
```

`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.
