> 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/fr/deploy-devolutions-agent-silently.md). # Déployer Devolutions Agent en mode silencieux Déployer Devolutions Agent en mode silencieux avec msiexec ou PowerShell, et choisir les composants à installer avec la propriété ADDLOCAL pour un déploiement de masse. 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](https://docs.devolutions.net/rdm/fr/ribbon-menu-bar/tools/all-tools/rdm-jump-deprecated) obsolète par Devolutions Agent sur les [hôtes Jump](/agent/fr/jump-host.md), 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`). {% hint style="warning" %} 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`. {% endhint %} ## 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. Les mêmes fonctionnalités, telles qu'elles s'affichent dans l'installateur interactif, sont décrites dans [Devolutions Agent](/agent/fr/readme.md#installation). | 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. Installe le composant qui ouvre le canal virtuel RDP utilisé par Remote Desktop Manager pour communiquer avec Devolutions Agent. Requis pour les connexions Jump à partir de Remote Desktop Manager par l'intermédiaire de Devolutions Agent, et donc sur chaque 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. | | `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](https://docs.devolutions.net/gateway/fr/knowledge-base/knowledge-base-articles/agent-tunnel). | | `F.PsuAgent` | PowerShell Universal Agent | Non installé | Active l'agent distant PowerShell Universal. 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. | {% hint style="info" %} 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. {% endhint %} ## 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 ` | É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" ``` {% hint style="warning" %} Sans `F.Updater`, Devolutions Agent ne peut pas se mettre à jour. Les mises à jour doivent alors être déployées avec vos propres outils. {% endhint %} {% hint style="info" %} N'ajoutez pas `F.Tunnel` ni `F.PsuAgent` à `ADDLOCAL` sans leurs propriétés requises. Sinon, l'installation silencieuse échoue. {% endhint %} ### 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. {% hint style="success" %} 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. {% endhint %} ### 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" ``` {% hint style="warning" %} 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. {% endhint %} ## 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. ```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 ``` Pour déployer sur plusieurs ordinateurs à partir d'un poste de gestion avec la communication à distance PowerShell activée : ```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" %} 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. {% endhint %} ## 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. {% hint style="warning" %} 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. {% endhint %} ## Désinstallation silencieuse Pour désinstaller Devolutions Agent en mode silencieux, recherchez son code de produit et exécutez `msiexec /x` : ```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" %} 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. {% endhint %} ## Voir aussi * [Hôte Jump](/agent/fr/jump-host.md) * [Blogue Devolutions – Remplacer RDM Agent par Devolutions Agent](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/fr/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.