Déployer Devolutions Agent en mode silencieux

L'installateur de Devolutions Agent est un paquet Windows Installer (MSI) standard. Il peut être installé en mode silencieux depuis la ligne de commande, par PowerShell ou par n'importe quel outil de déploiement logiciel (Microsoft Intune, Configuration Manager, stratégie de groupe, plateformes RMM, et ainsi de suite).

Lors d'une installation silencieuse, choisissez les composants de Devolutions Agent qui sont installés à l'aide de la propriété MSI standard ADDLOCAL. Cela est utile pour déployer Devolutions Agent sur de nombreux ordinateurs, par exemple pour remplacer l'agent RDM Jump obsolète par Devolutions Agent sur les hôtes Jump, ou pour omettre les composants qui ne sont pas nécessaires dans un environnement donné.

Prérequis

• Un ordinateur Windows disposant de droits d'administrateur local (ou un outil de déploiement exécuté en tant que SYSTEM).
• .NET Framework 4.8 ou version ultérieure.
• Le MSI de Devolutions Agent pour l'architecture cible, x64 ou arm64 (par exemple DevolutionsAgent-2026.3.0-x64.msi).

L'installateur ne permet pas les rétrogradations. Si une version plus récente est déjà installée, l'installation échoue avec le code de sortie 1603.

Composants de l'installateur

Chaque composant de l'installateur correspond à un ID de fonctionnalité. Utilisez ces ID dans ADDLOCAL (pour installer) ou REMOVE (pour retirer). Les ID de fonctionnalité respectent la casse.

ID DE FONCTIONNALITÉ	NOM DANS L'INSTALLATEUR	PAR DÉFAUT	DESCRIPTION
F.Agent	Devolutions Agent	Installé (obligatoire)	Installe le service Devolutions Agent. Toujours obligatoire. Parent de F.Updater, F.Tunnel et F.PsuAgent.
F.Session	RDP Extension	Installé	Active des fonctionnalités de session RDP telles que l'exécution à distance, les sessions Jump et la déconnexion à distance. Obligatoire lorsque l'ordinateur est utilisé comme hôte Jump.
F.Updater	Devolutions Gateway Updater	Installé	Le module de mise à jour de Devolutions Agent. Il gère les mises à jour de Devolutions Gateway et de Devolutions Cloud Services, ainsi que l'auto-mise à jour de Devolutions Agent. Sans lui, Devolutions Agent ne peut pas se mettre à jour. Il n'ajoute pas de surcharge notable, il est donc recommandé de le conserver.
F.Tunnel	Agent Tunnel	Non installé	Connecte Devolutions Agent à un Devolutions Gateway. Une installation silencieuse avec ce composant échoue si des propriétés supplémentaires ne sont pas transmises, comme la chaîne d'inscription de l'opérateur de la passerelle. Non traité dans cet article. Voir Agent tunnel.
F.PsuAgent	PowerShell Universal Agent	Non installé	Active l'agent distant PowerShell Universal. Expérimental. Une installation silencieuse avec ce composant échoue si des propriétés supplémentaires ne sont pas transmises, comme l'URL et le jeton de PowerShell Universal. Non traité dans cet article.
F.Pedm	Devolutions PEDM	Non installé	Active les fonctionnalités PEDM et installe l'extension du shell. Expérimental.

Si vous exécutez une installation silencieuse sans ADDLOCAL, les composants par défaut sont installés : Devolutions Agent, RDP Extension et Devolutions Gateway Updater.

Installation silencieuse

Composants par défaut

Pour installer Devolutions Agent avec ses composants par défaut, exécutez la commande suivante à partir d'une invite élevée :

msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart /l*v "C:\Windows\Temp\DevolutionsAgent_install.log"

COMMUTATEUR	OBJET
/i	Installer ou mettre à jour le paquet.
/qn	Aucune interface utilisateur (silencieux).
/norestart	Ne pas redémarrer l'ordinateur automatiquement.
/l*v <path>	Écrire un journal d'installation détaillé. Recommandé pour le dépannage.

Composants sélectionnés

Pour choisir les composants, transmettez ADDLOCAL avec une liste d'ID de fonctionnalité séparés par des virgules. F.Agent doit toujours être inclus. Tout composant qui n'est pas indiqué n'est pas installé.

L'exemple suivant est une configuration type pour un hôte Jump. Il installe Devolutions Agent avec RDP Extension et le module de mise à jour.

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"

L'exemple suivant installe Devolutions Agent avec RDP Extension, sans le module de mise à jour. Utilisez-le seulement si votre organisation ne veut pas que Devolutions Agent se mette à jour ou mette à jour d'autres composants Devolutions.

msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart ADDLOCAL="F.Agent,F.Session" /l*v "C:\Windows\Temp\DevolutionsAgent_install.log"

Sans F.Updater, Devolutions Agent ne peut pas se mettre à jour. Les mises à jour doivent alors être déployées avec vos propres outils.

N'ajoutez pas F.Tunnel ni F.PsuAgent à ADDLOCAL sans leurs propriétés requises. Sinon, l'installation silencieuse échoue.

Mettre à jour une installation existante

Lorsque vous installez une version plus récente par-dessus une version existante sans ADDLOCAL, l'installateur conserve les composants qui étaient déjà installés.

Lorsque vous transmettez ADDLOCAL, l'installateur utilise votre liste au lieu de la précédente. La même commande peut donc servir aux nouvelles installations et aux mises à jour. Par exemple, une mise à jour avec ADDLOCAL="F.Agent,F.Session" retire le module de mise à jour (F.Updater) s'il était installé auparavant.

Transmettez toujours ADDLOCAL dans votre paquet de déploiement. Ainsi, chaque ordinateur se retrouve avec les mêmes composants, quels que soient ceux qui y étaient installés auparavant.

Retirer un composant d'un Devolutions Agent installé

Pour retirer un composant d'un Devolutions Agent installé, exécutez le MSI de la version installée. Indiquez les composants que vous conservez dans ADDLOCAL et ceux que vous retirez dans REMOVE :

msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart ADDLOCAL="F.Agent,F.Session" REMOVE="F.Updater"

N'utilisez pas REMOVE seul. Par exemple, REMOVE="F.Updater" seul désactive aussi RDP Extension. Cela ne prend effet qu'après le prochain redémarrage du service ou le prochain redémarrage de l'ordinateur, le problème n'est donc pas visible tout de suite.

Script PowerShell de déploiement

Le script suivant peut être utilisé tel quel, ou comme commande d'installation d'un outil de déploiement. Il installe ou met à jour Devolutions Agent, vérifie le code de sortie et indique quels composants sont activés.

# 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

Pour déployer sur plusieurs ordinateurs à partir d'un poste de gestion avec la communication à distance PowerShell activée :

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

La copie depuis un partage réseau à l'intérieur d'une session distante peut échouer à cause de la délégation d'identifiants (double saut). Si cela se produit, copiez d'abord le MSI sur les ordinateurs cibles, ou laissez votre outil de déploiement le distribuer.

Codes de sortie

CODE DE SORTIE	SIGNIFICATION
0	L'installation a réussi.
3010	L'installation a réussi. Un redémarrage est requis pour la terminer.
1641	L'installation a réussi et un redémarrage a été lancé.
1603	Erreur fatale durant l'installation. Consultez le journal détaillé. Il s'agit aussi du code renvoyé lorsqu'une version plus récente est déjà installée (le journal affiche "A newer version of this product is already installed.").
1618	Une autre installation est en cours. Réessayez plus tard.

Vérifier l'installation

• Vérifiez que le service Devolutions Agent est en cours d'exécution avec Get-Service DevolutionsAgent.
• Ouvrez C:\ProgramData\Devolutions\Agent\agent.json. L'installateur écrit une valeur Enabled pour chaque composant facultatif. Par exemple, avec ADDLOCAL="F.Agent,F.Session", Session affiche "Enabled": true et Updater affiche "Enabled": false.
• Si quelque chose ne semble pas correct, ouvrez le journal d'installation détaillé (le fichier /l*v). Il énumère chaque fonctionnalité et son état d'installation.

Après l'installation

Aucun redémarrage ni aucune déconnexion n'est nécessaire après l'installation de Devolutions Agent.

La communication entre Remote Desktop Manager et Devolutions Agent passe par la connexion RDP, et ce canal est établi lorsque la connexion RDP est établie. Si Devolutions Agent est installé alors qu'une session RDP vers cet ordinateur est ouverte, fermez cette session RDP et ouvrez-la de nouveau. Les nouvelles connexions RDP établies après l'installation fonctionnent immédiatement.

Les sessions Jump, la déconnexion à distance et l'exécution à distance nécessitent RDP Extension (F.Session). Incluez-le dans ADDLOCAL sur chaque ordinateur où ces fonctionnalités sont utilisées.

Désinstallation silencieuse

Pour désinstaller Devolutions Agent en mode silencieux, recherchez son code de produit et exécutez msiexec /x :

$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

La désinstallation ne retire pas C:\ProgramData\Devolutions\Agent (y compris agent.json) ni la clé de registre HKLM\SOFTWARE\Devolutions\Agent. Supprimez-les manuellement si vous avez besoin d'un état propre, par exemple avant une réinstallation à neuf.

Voir aussi

• Hôte Jump
• Blogue Devolutions – Remplacer RDM Agent par Devolutions Agent