> 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

Stellen Sie den RealmJoin-Agent mit dem sofort einsatzbereiten intunewin-Paket aus dem Package Store über Intune auf Windows-Clients bereit.

Der RealmJoin Agent kann nahtlos mithilfe von Microsoft Intune bereitgestellt werden. Im Package Store steht ein sofort einsatzbereites 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 **Package Store**.
2. Wählen Sie das Banner "RealmJoin Agent" oder verwenden Sie diesen Direktlink: [RealmJoin-Agent (Device)](https://portal.realmjoin.com/packagestore/45935/overview)<br>

   <figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FfeIw2aeCYivyheibRk7N%2Fimage.png?alt=media&amp;token=8a94847c-a5e6-4ba6-80cf-9256506ae53d" 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 "**Enrollment Status Page**" unter "Block device use until required apps are installed if they are assigned to the user/device" hinzu. Dadurch stellt Intune sicher, dass bei der Registrierung auf die Installation des RealmJoin Agent gewartet wird.
5. Bitte aktivieren Sie auch "**Automation Main channel**".

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FYo2RBeON8S2CiF5Eh7cq%2Fimage.png?alt=media&amp;token=05cd015a-384b-44a4-8ab8-132646de8598" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Der RealmJoin Agent wird **nach neueren Versionen suchen** während **der Erstbereitstellung** und **bei Bedarf aktualisieren**. Um diesen Prozess zu beschleunigen, empfehlen wir weiterhin "Automate Main channel". Dadurch wird sichergestellt, dass von Anfang an die aktuellste Version 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 Konfiguration der "Enrollment Status Page" entfernt wird.
{% endhint %}

6. **Weisen Sie** das Paket auf **Geräte** (wenn es Benutzerobjekten zugewiesen ist, 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 (User)" an, das auf Benutzerebene ausgeführt wird (was in der Vergangenheit 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](https://docs.realmjoin.com/de/ugd-management/user-and-group-settings.md). Nur **bei der Erstbereitstellung**, die **wird der Kanal durch den Installer definiert und festgelegt** Paket. Bei Verwendung von [Automatische Bereitstellung](#automatic-deployment) mit unserem Package Store werden Bereitstellungen immer den Release-Kanal verwenden.
{% endhint %}

Für **zum Testen von Erstbereitstellungen mit anderen Kanälen**, können Sie eines der folgenden intunewin-Pakete manuell herunterladen und hochladen:

* Beta-Kanal (nahezu 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 Neustart des Geräts: `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 zunehmend Machine-Learning-Mechanismen verwendet, um potenzielle Bedrohungen zu identifizieren, und RealmJoin über mehrere Funktionen wie aus der Cloud heruntergeladene Anwendungsinstallationen verfügt, könnte RealmJoin von **Windows Defender** als potenzielle 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**. 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" %}
Diese **veraltete Bereitstellungsmethode** wird nur zu Referenzzwecken bereitgestellt und wird **nicht mehr unterstützt**.

Beachten Sie außerdem, dass [Microsoft nicht empfiehlt, MSI- und intunewin-Bereitstellungen zu mischen](https://learn.microsoft.com/en-us/intune/intune-service/apps/lob-apps-windows): "Wenn Sie bei der Windows Autopilot-Registrierung 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 ü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="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FrShHt2tT5AvEUqx4gikB%2Fimage.png?alt=media&amp;token=ed311281-dd1b-4d42-bb9f-5cb13edee9e5" alt="" width="364"><figcaption></figcaption></figure>

### Interaktive Installation per Befehlszeile

Wenn ein Administrator RealmJoin Agent auf einem Gerät ohne Massenbereitstellung oder ohne 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 unten stehenden 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 (nahezu 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 Benutzeroberflächeninteraktion zu haben. 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 von RealmJoin mit SHA2 (256 Bit) signiert und wird daher von Windows als sicher zu installierende Datei erkannt.

![](https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FLgoUYkRJF8acq3qRvNfj%2Frealmjoin.msi.signature.png?alt=media\&token=b33acfc4-8f6f-4813-adeb-ac6c5c2e59cc)


---

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