> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/agent/de/deploy-devolutions-agent-silently.md). # Devolutions Agent still bereitstellen Devolutions Agent still mit msiexec oder PowerShell bereitstellen und auswählen, welche Komponenten mit der Eigenschaft ADDLOCAL für die Massenbereitstellung installiert werden. Das Installationsprogramm von Devolutions Agent ist ein standardmäßiges Windows Installer-Paket (MSI). Es kann still über die Befehlszeile, über PowerShell oder über ein beliebiges Softwarebereitstellungstool installiert werden (Microsoft Intune, Configuration Manager, Gruppenrichtlinie, RMM-Plattformen und so weiter). Wählen Sie während einer stillen Installation mit der standardmäßigen MSI-Eigenschaft `ADDLOCAL` aus, welche Komponenten von Devolutions Agent installiert werden. Das ist nützlich, wenn Devolutions Agent auf vielen Computern bereitgestellt wird, beispielsweise um den veralteten [RDM Jump-Agent](https://docs.devolutions.net/rdm/de/ribbon-menu-bar/tools/all-tools/rdm-jump-deprecated) auf [Jump-Hosts](/agent/de/jump-host.md) durch Devolutions Agent zu ersetzen oder um Komponenten auszulassen, die in einer bestimmten Umgebung nicht benötigt werden. ## Voraussetzungen * Ein Windows-Computer mit lokalen Administratorrechten (oder ein Bereitstellungstool, das als SYSTEM ausgeführt wird). * .NET Framework 4.8 oder höher. * Das Devolutions Agent-MSI für die Zielarchitektur, x64 oder arm64 (zum Beispiel `DevolutionsAgent-2026.3.0-x64.msi`). {% hint style="warning" %} Das Installationsprogramm lässt keine Downgrades zu. Wenn bereits eine neuere Version installiert ist, schlägt die Installation mit dem Exitcode `1603` fehl. {% endhint %} ## Installerkomponenten Jede Komponente im Installationsprogramm entspricht einer Funktions-ID. Verwenden Sie diese IDs in `ADDLOCAL` (zum Installieren) oder `REMOVE` (zum Entfernen). Bei Funktions-IDs wird die Groß-/Kleinschreibung beachtet. Dieselben Funktionen, wie sie im interaktiven Installationsprogramm angezeigt werden, sind unter [Devolutions Agent](/agent/de/readme.md#installation) beschrieben. | FUNKTIONS-ID | NAME IM INSTALLATIONSPROGRAMM | STANDARD | BESCHREIBUNG | | ------------ | ----------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `F.Agent` | Devolutions Agent | Installiert (erforderlich) | Installiert den Devolutions Agent-Dienst. Immer erforderlich. Übergeordnetes Element von `F.Updater`, `F.Tunnel` und `F.PsuAgent`. | | `F.Session` | RDP Extension | Installiert | Aktiviert Funktionen für RDP-Sitzungen wie Remoteausführung, Jump-Sitzungen und Remoteabmeldung. Installiert die Komponente, die den virtuellen RDP-Kanal öffnet, über den Remote Desktop Manager mit Devolutions Agent kommuniziert. Erforderlich für Jump-Verbindungen von Remote Desktop Manager über Devolutions Agent und daher auf jedem Jump-Host. | | `F.Updater` | Devolutions Gateway Updater | Installiert | Das Updatemodul von Devolutions Agent. Es verarbeitet Updates von Devolutions Gateway und Devolutions Cloud Services sowie die Selbstaktualisierung von Devolutions Agent. Ohne dieses Modul kann Devolutions Agent sich nicht selbst aktualisieren. | | `F.Tunnel` | Agent Tunnel | Nicht installiert | Verbindet Devolutions Agent mit einem Devolutions Gateway. Eine stille Installation mit dieser Komponente schlägt fehl, wenn nicht zusätzliche Eigenschaften übergeben werden, etwa die Registrierungszeichenfolge des Gateway-Operators. In diesem Artikel nicht behandelt. Siehe [Agent-Tunnel](https://docs.devolutions.net/gateway/de/knowledge-base/knowledge-base-articles/agent-tunnel). | | `F.PsuAgent` | PowerShell Universal Agent | Nicht installiert | Aktiviert den PowerShell Universal-Remote-Agent. Eine stille Installation mit dieser Komponente schlägt fehl, wenn nicht zusätzliche Eigenschaften übergeben werden, etwa die PowerShell Universal-URL und das Token. In diesem Artikel nicht behandelt. | | `F.Pedm` | Devolutions PEDM | Nicht installiert | Aktiviert PEDM-Funktionen und installiert die Shellerweiterung. Experimentell. | {% hint style="info" %} Wenn Sie eine stille Installation ohne `ADDLOCAL` ausführen, werden die Standardkomponenten installiert: Devolutions Agent, RDP Extension und Devolutions Gateway Updater. {% endhint %} ## Stille Installation ### Standardkomponenten Um Devolutions Agent mit den Standardkomponenten zu installieren, führen Sie den folgenden Befehl an einer Eingabeaufforderung mit erhöhten Rechten aus: ``` msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart /l*v "C:\Windows\Temp\DevolutionsAgent_install.log" ``` | SCHALTER | ZWECK | | ------------- | ------------------------------------------------------------------------------------ | | `/i` | Paket installieren oder aktualisieren. | | `/qn` | Keine Benutzeroberfläche (still). | | `/norestart` | Computer nicht automatisch neu starten. | | `/l*v ` | Ein ausführliches Installationsprotokoll schreiben. Zur Problembehandlung empfohlen. | ### Ausgewählte Komponenten Um die Komponenten auszuwählen, übergeben Sie `ADDLOCAL` mit einer durch Kommas getrennten Liste von Funktions-IDs. `F.Agent` muss immer enthalten sein. Jede Komponente, die nicht aufgeführt ist, wird nicht installiert. Das folgende Beispiel ist eine typische Einrichtung für einen Jump-Host. Es installiert Devolutions Agent mit der RDP Extension und dem Updatemodul. ``` msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart ADDLOCAL="F.Agent,F.Updater,F.Session" /l*v "C:\Windows\Temp\DevolutionsAgent_install.log" ``` Das folgende Beispiel installiert Devolutions Agent mit der RDP Extension, ohne das Updatemodul. Verwenden Sie es nur, wenn Ihre Organisation nicht möchte, dass Devolutions Agent sich selbst oder andere Devolutions-Komponenten aktualisiert. ``` msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart ADDLOCAL="F.Agent,F.Session" /l*v "C:\Windows\Temp\DevolutionsAgent_install.log" ``` {% hint style="warning" %} Ohne `F.Updater` kann Devolutions Agent sich nicht selbst aktualisieren. Updates müssen dann mit Ihren eigenen Tools bereitgestellt werden. {% endhint %} {% hint style="info" %} Fügen Sie `F.Tunnel` oder `F.PsuAgent` nicht zu `ADDLOCAL` hinzu, ohne die erforderlichen Eigenschaften. Andernfalls schlägt die stille Installation fehl. {% endhint %} ### Eine vorhandene Installation aktualisieren Wenn Sie eine neuere Version über eine vorhandene ohne `ADDLOCAL` installieren, behält das Installationsprogramm die Komponenten bei, die bereits installiert waren. Wenn Sie `ADDLOCAL` übergeben, verwendet das Installationsprogramm Ihre Liste anstelle der vorherigen. Derselbe Befehl kann daher für neue Installationen und für Updates verwendet werden. Beispielsweise entfernt eine Aktualisierung mit `ADDLOCAL="F.Agent,F.Session"` das Updatemodul (`F.Updater`), falls es zuvor installiert war. {% hint style="success" %} Übergeben Sie `ADDLOCAL` immer in Ihrem Bereitstellungspaket. So erhält jeder Computer dieselben Komponenten, unabhängig davon, was zuvor darauf installiert war. {% endhint %} ### Eine Komponente von einem installierten Devolutions Agent entfernen Um eine Komponente von einem installierten Devolutions Agent zu entfernen, führen Sie das MSI der installierten Version aus. Listen Sie die Komponenten, die Sie behalten, in `ADDLOCAL` und die, die Sie entfernen, in `REMOVE` auf: ``` msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart ADDLOCAL="F.Agent,F.Session" REMOVE="F.Updater" ``` {% hint style="warning" %} Verwenden Sie `REMOVE` nicht allein. Beispielsweise schaltet `REMOVE="F.Updater"` allein auch die RDP Extension aus. Dies wird erst nach dem nächsten Dienstneustart oder Neustart wirksam, das Problem ist also nicht sofort sichtbar. {% endhint %} ## PowerShell-Bereitstellungsskript Das folgende Skript kann unverändert verwendet werden oder als Installationsbefehl eines Bereitstellungstools. Es installiert oder aktualisiert Devolutions Agent, prüft den Exitcode und meldet, welche Komponenten aktiviert sind. ```powershell # Deploy-DevolutionsAgent.ps1 # Installs or updates Devolutions Agent silently with the selected components. # Run as administrator (or as SYSTEM through your deployment tool). $msi = "\\fileserver\share\DevolutionsAgent-2026.3.0-x64.msi" $features = "F.Agent,F.Updater,F.Session" # Agent service + update module + RDP Extension $log = "C:\Windows\Temp\DevolutionsAgent_install.log" $arguments = "/i `"$msi`" /qn /norestart ADDLOCAL=`"$features`" /l*v `"$log`"" $process = Start-Process -FilePath "msiexec.exe" -ArgumentList $arguments -Wait -PassThru if ($process.ExitCode -notin 0, 1641, 3010) { Write-Error "Devolutions Agent installation failed (exit code $($process.ExitCode)). See $log" exit $process.ExitCode } # Verify which components are enabled $config = Get-Content "C:\ProgramData\Devolutions\Agent\agent.json" -Raw | ConvertFrom-Json Write-Output "Service status : $((Get-Service DevolutionsAgent).Status)" Write-Output "RDP Extension enabled : $($config.Session.Enabled)" Write-Output "Update module enabled : $($config.Updater.Enabled)" exit $process.ExitCode ``` Um auf mehreren Computern von einer Verwaltungsarbeitsstation mit aktiviertem PowerShell-Remoting bereitzustellen: ```powershell $computers = Get-Content "C:\Deploy\computers.txt" $msiShare = "\\fileserver\share\DevolutionsAgent-2026.3.0-x64.msi" Invoke-Command -ComputerName $computers -ArgumentList $msiShare -ScriptBlock { param($source) $local = "C:\Windows\Temp\DevolutionsAgent.msi" Copy-Item $source $local -Force $arguments = "/i `"$local`" /qn /norestart ADDLOCAL=`"F.Agent,F.Updater,F.Session`" /l*v C:\Windows\Temp\DevolutionsAgent_install.log" $p = Start-Process msiexec.exe -ArgumentList $arguments -Wait -PassThru [pscustomobject]@{ Computer = $env:COMPUTERNAME; ExitCode = $p.ExitCode } } ``` {% hint style="info" %} Das Kopieren von einer Netzwerkfreigabe innerhalb einer Remotesitzung kann wegen der Delegierung von Anmeldeinformationen (Double-Hop) fehlschlagen. Kopieren Sie in diesem Fall das MSI zuerst auf die Zielcomputer, oder lassen Sie es von Ihrem Bereitstellungstool verteilen. {% endhint %} ## Exitcodes | EXITCODE | BEDEUTUNG | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `0` | Die Installation war erfolgreich. | | `3010` | Die Installation war erfolgreich. Ein Neustart ist erforderlich, um sie abzuschließen. | | `1641` | Die Installation war erfolgreich und ein Neustart wurde gestartet. | | `1603` | Schwerwiegender Fehler während der Installation. Prüfen Sie das ausführliche Protokoll. Dies ist auch der Code, der zurückgegeben wird, wenn bereits eine neuere Version installiert ist (das Protokoll zeigt "A newer version of this product is already installed."). | | `1618` | Eine andere Installation wird ausgeführt. Versuchen Sie es später erneut. | ## Installation überprüfen * Prüfen Sie, ob der Devolutions Agent-Dienst ausgeführt wird, mit `Get-Service DevolutionsAgent`. * Öffnen Sie `C:\ProgramData\Devolutions\Agent\agent.json`. Das Installationsprogramm schreibt einen `Enabled`-Wert für jede optionale Komponente. Beispielsweise zeigt `Session` bei `ADDLOCAL="F.Agent,F.Session"` den Wert `"Enabled": true` und `Updater` den Wert `"Enabled": false`. * Wenn etwas nicht richtig aussieht, öffnen Sie das ausführliche Installationsprotokoll (die Datei `/l*v`). Es listet jede Funktion und ihren Installationsstatus auf. ## Nach der Installation Nach der Installation von Devolutions Agent ist kein Neustart und keine Abmeldung erforderlich. Die Kommunikation zwischen Remote Desktop Manager und Devolutions Agent erfolgt über die RDP-Verbindung, und dieser Kanal wird eingerichtet, wenn die RDP-Verbindung hergestellt wird. Wenn Devolutions Agent installiert wird, während eine RDP-Sitzung zu diesem Computer geöffnet ist, schließen Sie diese RDP-Sitzung und öffnen Sie sie erneut. Neue RDP-Verbindungen, die nach der Installation hergestellt werden, funktionieren sofort. {% hint style="warning" %} Jump-Sitzungen, Remoteabmeldung und Remoteausführung benötigen die RDP Extension (`F.Session`). Nehmen Sie sie auf jedem Computer in `ADDLOCAL` auf, auf dem diese Funktionen verwendet werden. {% endhint %} ## Stille Deinstallation Um Devolutions Agent still zu deinstallieren, ermitteln Sie den Produktcode und führen Sie `msiexec /x` aus: ```powershell $app = Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*" | Where-Object { $_.DisplayName -eq "Devolutions Agent" } $arguments = "/x $($app.PSChildName) /qn /norestart /l*v C:\Windows\Temp\DevolutionsAgent_uninstall.log" Start-Process msiexec.exe -ArgumentList $arguments -Wait ``` {% hint style="info" %} Die Deinstallation entfernt nicht `C:\ProgramData\Devolutions\Agent` (einschließlich `agent.json`) oder den Registrierungsschlüssel `HKLM\SOFTWARE\Devolutions\Agent`. Löschen Sie sie manuell, wenn Sie einen bereinigten Zustand benötigen, beispielsweise vor einer Neuinstallation. {% endhint %} ## Siehe auch * [Jump Host](/agent/de/jump-host.md) * [Devolutions Blog – RDM Agent durch Devolutions Agent ersetzen](https://devolutions.net/blog/replacing-rdm-agent-with-devolutions-agent/) --- # 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.devolutions.net/agent/de/deploy-devolutions-agent-silently.md?ask=&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.