# Bereitstellung des Agents

Der RealmJoin Agent kann nahtlos über Microsoft Intune bereitgestellt werden. Ein sofort verwendbares Paket ist in unserem Package Store verfügbar, was 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 Direktlink: [RealmJoin Agent (Gerät)](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&#x26;token=8a94847c-a5e6-4ba6-80cf-9256506ae53d" alt=""><figcaption></figcaption></figure>
3. Wählen Sie "**Use Intune (managed)**" als Bereitstellungsmethode und klicken Sie auf "Weiter".
4. Fügen Sie dieses Paket Ihrer "**Enrollment Status Page**" unter "Block device use until required apps are installed if they are assigned to the user/device" hinzu. Dadurch wird sichergestellt, dass Intune während der Registrierung auf die Installation des RealmJoin Agent wartet.
5. Bitte aktivieren Sie außerdem "**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&#x26;token=05cd015a-384b-44a4-8ab8-132646de8598" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
RealmJoin agent will **nach neueren Versionen suchen** während **der Erstbereitstellung** und **falls erforderlich aktualisieren**. Um diesen Prozess zu beschleunigen, empfehlen wir dennoch "Automate Main channel". Dadurch wird sichergestellt, dass direkt von Beginn an die aktuellste Version installiert wird.
{% endhint %}

{% hint style="warning" %}
Bitte **verwenden Sie nicht "Automate Preview channel"** da sich die **intunewin-Anwendungs-ID ändern kann** was das Paket aus Ihrer Konfiguration der "Enrollment Status Page" entfernen würde.
{% endhint %}

6. **Weisen Sie** das Paket **Geräten** zu (wenn es Benutzerobjekten zugewiesen wird, startet der Agent möglicherweise während der Bereitstellung nicht), z. B.:
   1. Hinzufügen **einzelnen Geräten oder Gerätegruppen** 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 außerdem das Paket "RealmJoin Agent (User)" 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](https://docs.realmjoin.com/de/ugd-management/user-and-group-settings). Nur **während der Erstbereitstellung**ist der **Kanal durch das Installationspaket definiert und festgelegt. Bei der Verwendung** mit unserem Package Store verwenden Bereitstellungen immer den Release-Kanal. [Automatische Bereitstellung](#automatic-deployment) Zum Testen von Erstbereitstellungen mit anderen Kanälen
{% endhint %}

Für **können Sie eines der folgenden intunewin-Pakete manuell herunterladen und hochladen:**&#x42;eta-Kanal (nahe an stabil, für Langzeittests):

* RealmJoin Beta-Version\
  [Canary-Kanal (experimentell, erste Tests):](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)
* RealmJoin Canary-Version\
  [Beim Hochladen nach Intune verwenden Sie bitte die vorgeschlagenen Einstellungen und:](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoinSystemInstallEspDeviceSetupOnly.intunewin)

Programm:

* Neustartverhalten 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:`
    * Windows Defender-Ausnahmen `Kein`

## 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 Anwendungsinstallationen bietet, könnte RealmJoin von

Windows Defender **als mögliche Bedrohung erkannt werden.** Obwohl 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`                                      |
| **Es ist wichtig, denselben Pfad in**           |
| `%ProgramFiles%\RealmJoin\RealmJoin.exe`        |
| `%ProgramFiles%\RealmJoin\RealmJoinService.exe` |
| `%ProgramFiles%\RealmJoin\RealmJoinUpdate.exe`  |
| `Prozesse`                                      |

{% hint style="info" %}
zu konfigurieren. In einigen Fällen prüft Microsoft nur eine dieser Defender-Ausnahmen. **%ProgramFiles%\RealmJoin** und **Es ist wichtig, denselben Pfad in**Zusätzliche Informationen
{% endhint %}

## Legacy: Microsoft Intune (MSI)

### Automatische Bereitstellung

#### Diese

{% hint style="warning" %}
veraltete 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 [: "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."](https://learn.microsoft.com/en-us/intune/intune-service/apps/lob-apps-windows)RealmJoin kann über
{% endhint %}

MSI-Installer [als Line-of-Business-App bereitgestellt werden. Stellen Sie beim Hochladen nach Intune sicher, dass "Ignorieren der App-Version" auf "Ja" gesetzt ist.](#msi-installer) Interaktive Installation über die Befehlszeile

<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&#x26;token=ed311281-dd1b-4d42-bb9f-5cb13edee9e5" alt="" width="364"><figcaption></figcaption></figure>

### Wenn ein Administrator RealmJoin Agent auf einem Gerät ohne Massenbereitstellung oder die Microsoft-Intune-Infrastruktur installieren möchte, kann man die MSI-Datei 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

#### Stabile Version:

* MSI\
  [Release-Kanal](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.msi) oder [EXE](https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe)
* RealmJoin Beta-Version\
  [Release-Kanal](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.msi) oder [EXE](https://gkrealmjoin.s3.amazonaws.com/win-beta/RealmJoin.exe)
* RealmJoin Canary-Version\
  [Release-Kanal](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.msi) oder [EXE](https://gkrealmjoin.s3.amazonaws.com/win-canary/RealmJoin.exe)

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

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

#### Beta-Kanal

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

#### Canary-Kanal

```
Stille Installation
```

### Wenn Sie RealmJoin während einer unbeaufsichtigten Betriebssysteminstallation oder einer anderen nicht interaktiven Bereitstellungsmethode installieren, möchten Sie möglicherweise während der Installation keine Benutzeroberfläche verwenden. 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 Software erkannt.

Rogii StarSteer Python-Bibliotheken

![](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)
