Devolutions Agent still bereitstellen

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 auf Jump-Hosts 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).

Das Installationsprogramm lässt keine Downgrades zu. Wenn bereits eine neuere Version installiert ist, schlägt die Installation mit dem Exitcode 1603 fehl.

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.

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. Erforderlich, wenn der Computer als Jump-Host verwendet wird.
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. Es verursacht keinen spürbaren Mehraufwand, daher wird empfohlen, es beizubehalten.
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.
F.PsuAgent	PowerShell Universal Agent	Nicht installiert	Aktiviert den PowerShell Universal-Remote-Agent. Experimentell. 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.

Wenn Sie eine stille Installation ohne ADDLOCAL ausführen, werden die Standardkomponenten installiert: Devolutions Agent, RDP Extension und Devolutions Gateway Updater.

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 <path>	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"

Ohne F.Updater kann Devolutions Agent sich nicht selbst aktualisieren. Updates müssen dann mit Ihren eigenen Tools bereitgestellt werden.

Fügen Sie F.Tunnel oder F.PsuAgent nicht zu ADDLOCAL hinzu, ohne die erforderlichen Eigenschaften. Andernfalls schlägt die stille Installation fehl.

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.

Übergeben Sie ADDLOCAL immer in Ihrem Bereitstellungspaket. So erhält jeder Computer dieselben Komponenten, unabhängig davon, was zuvor darauf installiert war.

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"

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.

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.

# 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:

$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 }
}

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.

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.

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.

Stille Deinstallation

Um Devolutions Agent still zu deinstallieren, ermitteln Sie den Produktcode und führen Sie msiexec /x aus:

$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

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.

Siehe auch

• Jump Host
• Devolutions Blog – RDM Agent durch Devolutions Agent ersetzen