> 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 über Microsoft Intune bereitgestellt werden. Ein sofort einsatzbereites Paket ist in unserem Package Store verfügbar und vereinfacht den Einrichtungsprozess.\ 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 es den Agent als intunewin-Paket hinzufügt und aktualisiert: 1. Öffnen Sie unseren **Paket-Store**. 2. Wählen Sie das Banner "RealmJoin Agent" oder verwenden Sie diesen direkten Link: [RealmJoin Agent (Device)](https://portal.realmjoin.com/packagestore/45935/overview)
3. Wählen Sie "**Intune (verwaltet) verwenden**" als Bereitstellungsmethode und klicken Sie auf "Weiter". 4. Fügen Sie dieses Paket Ihrer "**Statusseite für die Registrierung**" unter "Gerätnutzung blockieren, bis erforderliche Apps installiert sind, wenn sie dem Benutzer/Gerät zugewiesen sind" hinzu. Dadurch wartet Intune während der Registrierung auf die Installation des RealmJoin Agent. 5. Bitte aktivieren Sie auch "**Hauptkanal automatisieren**".
{% hint style="info" %} Der RealmJoin-Agent wird **nach neueren Versionen prüfen** während **der Erstbereitstellung** und **bei Bedarf aktualisieren**. Um diesen Prozess zu beschleunigen, empfehlen wir weiterhin "Hauptkanal automatisieren". Dadurch wird sichergestellt, dass von Anfang an die aktuellste Version installiert wird. {% endhint %} {% hint style="warning" %} Bitte **verwenden Sie nicht "Vorschaukanal automatisieren"** da die **intunewin-Anwendungs-ID sich ändern kann** was das Paket aus Ihrer Konfiguration der "Statusseite für die Registrierung" entfernen würde. {% endhint %} 6. **Zuweisen** das Paket **Geräten** (wenn es Benutzerobjekten zugewiesen wird, startet der Agent während der Bereitstellung möglicherweise nicht), z. B.: 1. Fügen Sie **einzelne Geräte oder Gerätegruppe/n** zu den automatisch erstellten verwalteten App-Gruppen hinzu 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 (dies war in der Vergangenheit standardmäßig der Fall). Aus **Stabilitätsgründen**, empfehlen wir nun **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-Releasekanal konfigurieren](/de/ugd-management/user-and-group-settings.md). Nur **während der Erstbereitstellung**, wird der **Kanal durch das Installationspaket definiert und festgelegt** Bei Verwendung von [Automatische Bereitstellung](#automatic-deployment) mit unserem Package Store verwenden Bereitstellungen immer den Release-Kanal. {% endhint %} Für **Testen von Erstbereitstellungen mit anderen Kanälen**, können Sie eines der folgenden intunewin-Pakete manuell herunterladen und hochladen: * Beta-Kanal (nahe am stabilen Kanal, 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 nach Intune verwenden Sie bitte die vorgeschlagenen Einstellungen und: * 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` * Zugeordnet zu 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 cloudbasierte Anwendungsinstallationen hat, 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** | | `%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 prüft Microsoft nur eine dieser Defender-Ausnahmen. {% endhint %} ## Zusätzliche Informationen ### Automatische Bereitstellung #### Legacy: Microsoft Intune (MSI) {% hint style="warning" %} Dies **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 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 bereitgestellt werden über [MSI-Installationsprogramm](#msi-installer) als Line-of-Business-App. Achten Sie beim Hochladen nach Intune darauf, dass "App-Version ignorieren" auf "Ja" gesetzt ist.
### 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-Installationsprogramm 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 am stabilen Kanal, 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 Die RealmJoin.MSI ist von RealmJoin mit SHA2 (256 Bit) signiert und wird daher von Windows als sicher zu installierendes Paket 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=&goal= ``` `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.