# Bereitstellung des Agents

Der RealmJoin Agent kann nahtlos mit Microsoft Intune bereitgestellt werden. Ein sofort einsatzbereites Paket ist in unserem Package Store verfügbar, was den Einrichtungsprozess vereinfacht.\
Dieser Leitfaden 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 **Paketstore**.
2. Wählen Sie das Banner „RealmJoin Agent“ oder verwenden Sie diesen Direktlink: [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 und klicken Sie auf „Weiter“.
4. Fügen Sie dieses Paket zu Ihrer „**Registrierungsstatusseite**“ 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 Registrierung auf die Installation des RealmJoin Agent wartet.
5. Bitte aktivieren Sie auch „**Automatisierung Hauptkanal**".

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

{% hint style="info" %}
RealmJoin Agent wird **nach neueren Versionen suchen** während der **Erstbereitstellung** und **bei Bedarf aktualisieren**. Um diesen Prozess zu beschleunigen, empfehlen wir dennoch „Automatisierung Hauptkanal“. Dadurch wird sichergestellt, dass von Anfang an die aktuellste Version installiert wird.
{% endhint %}

{% hint style="warning" %}
Bitte **verwenden Sie nicht „Automatisierung Vorschaukanal“** da sich die **intunewin-Anwendungs-ID ändern kann** wodurch das Paket aus Ihrer Konfiguration der „Registrierungsstatusseite“ entfernt wird.
{% endhint %}

6. **Weisen Sie** das Paket **Geräten** zu (wenn es Benutzerobjekten zugewiesen wird, startet der Agent während der Bereitstellung möglicherweise nicht), z. B.:
   1. Hinzufügen **einzelne Geräte oder Gerätegruppe(n)** zu 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 ausgeführt wird (was früher der Standard war). Aus **Stabilitätsgründen**empfehlen wir jetzt **nur noch die Version auf Geräteebene**.
{% endhint %}

## Beta- und Canary-Kanal

{% hint style="info" %}
Der 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 Erstbereitstellung**wird der **Kanal durch das Installer-** Paket definiert und festgelegt. Bei Verwendung [Automatische Bereitstellung](#automatic-deployment) mit unserem Package Store verwenden Bereitstellungen immer den Release-Kanal.
{% endhint %}

Für **Erstbereitstellungen mit anderen Kanälen testen**, können Sie eines 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, erste Tests):\
  [RealmJoin Canary-Version](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)

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

* Programm:
  * Verhalten beim Geräteneustart: `Verhalten anhand von Rückgabecodes bestimmen`
* Erkennungsregeln:
  * Erkennungsregeln manuell konfigurieren
  * Datei:
    * Pfad: `C:\Program Files\RealmJoin`
    * Datei oder Ordner: `RealmJoin.exe`
    * Erkennungsmethode: `Datei oder Ordner vorhanden`
    * Mit einer 32-Bit-App auf 64-Bit-Clients verknüpft: `Kein`

## Windows Defender-Ausnahmen

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

Obwohl dieses Verhalten nicht sicher auftritt, 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 prüft Microsoft nur eine dieser Defender-Ausnahmen.
{% endhint %}

## Zusätzliche Informationen

### Automatische Bereitstellung

#### Legacy: Microsoft Intune (MSI)

{% hint style="warning" %}
Diese **Legacy-Bereitstellungsmethode** wird nur zu Referenzzwecken bereitgestellt und wird **nicht mehr unterstützt**.

Beachten Sie außerdem, 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 die Installation von Win32-Apps und Line-of-Business-Apps während der Windows Autopilot-Registrierung mischen, kann die App-Installation fehlschlagen, da beide gleichzeitig den Trusted Installer-Dienst verwenden.“
{% endhint %}

RealmJoin kann über [MSI-Installer](#msi-installer) als Line-of-Business-App bereitgestellt werden. 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 über die 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 Agent in einem einzigen Schritt herunterzuladen und auszuführen.

#### MSI-Installer und EXE

* Stabiles Release:\
  [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, erste Tests):\
  [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

Bei der Installation von RealmJoin während einer unbeaufsichtigten Betriebssysteminstallation oder einer anderen nicht interaktiven Bereitstellungsmethode können Sie entscheiden, während der Installation keine UI-Interaktion zuzulassen. Um RealmJoin in einem solchen Szenario zu installieren, verwenden Sie die Option für die stille Installation:

```
reamjoin.exe -install
```

### Signiertes MSI

Die RealmJoin.MSI ist mit SHA2 (256 Bit) von RealmJoin signiert und wird daher von Windows als sicher für die Installation erkannt.

![](/files/957f1e36f415490cf8ecee8189e9fc1566b542af)


---

# Agent Instructions: 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:

```
GET https://docs.realmjoin.com/de/realmjoin-agent/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
