> 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 problemlos über Microsoft Intune bereitgestellt werden. Ein sofort einsatzbereites Paket ist in unserem Package Store verfügbar und vereinfacht den Einrichtungsprozess.\ 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 **Paketspeicher**. 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)
3. Wählen Sie "**Intune (verwaltet)**" als Bereitstellungsmethode aus und klicken Sie auf "Fortfahren". 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 stellt Intune sicher, dass während der Registrierung auf die Installation des RealmJoin Agent gewartet wird. 5. Bitte aktivieren Sie außerdem "**Hauptkanal automatisieren**".
{% 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 "Hauptkanal automatisieren". Dadurch wird sichergestellt, dass gleich zu Beginn die aktuellste Version installiert wird. {% endhint %} {% hint style="warning" %} Bitte **verwenden Sie nicht "Vorschaukanal automatisieren"** 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 **Geräten** (wenn es Benutzerobjekten zugewiesen wird, 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 außerdem das Paket "RealmJoin Agent (User)" an, das auf Benutzerebene ausgeführt wird (was früher der Standard war). Für **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 Installations** paket definiert. Bei Verwendung von [Automatische Bereitstellung](#automatic-deployment) unserem Package Store verwenden Bereitstellungen immer den Freigabekanal. {% endhint %} Für **Initiale Bereitstellungen mit anderen Kanälen testen**, können Sie eines der folgenden intunewin-Pakete manuell herunterladen und hochladen: * Beta-Kanal (nahezu stabil, für langfristige Tests):\ [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 zu 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: `Nein` ## Windows Defender-Ausnahmen RealmJoin hat mit dem Microsoft Defender-Team zusammengearbeitet, um von der Malware-Erkennung ausgenommen zu werden. Da Defender immer stärker Machine-Learning-Mechanismen zur Identifizierung potenzieller Bedrohungen verwendet und RealmJoin mehrere Funktionen wie aus der Cloud heruntergeladene Anwendungsinstallationen bietet, 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**. 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" %} Dies **veraltete Bereitstellungsmethode** wird nur zu Referenzzwecken bereitgestellt und ist **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 während 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 zu Intune sicher, dass "App-Version ignorieren" auf "Ja" gesetzt ist.
### Interaktive Installation per Befehlszeile 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](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 langfristige Tests):\ [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) #### Freigabekanal ``` @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 ``` ### Unbeaufsichtigte 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 anzeigen. Um RealmJoin in einem solchen Szenario zu installieren, verwenden Sie die Option für die unbeaufsichtigte 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 installieren 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: ``` GET https://docs.realmjoin.com/de/realmjoin-agent/installation.md?ask= ``` 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.