Desplegar Devolutions Agent de forma silenciosa

El instalador de Devolutions Agent es un paquete estándar de Windows Installer (MSI). Puede instalarse de forma silenciosa desde la línea de comandos, mediante PowerShell o mediante cualquier herramienta de implementación de software (Microsoft Intune, Configuration Manager, directiva de grupo, plataformas RMM y así sucesivamente).

Durante una instalación silenciosa, elija qué componentes de Devolutions Agent se instalan con la propiedad MSI estándar ADDLOCAL. Esto es útil al implementar Devolutions Agent en muchos ordenadores, por ejemplo para sustituir el agente RDM Jump obsoleto por Devolutions Agent en jump hosts, o para omitir componentes que no se necesitan en un entorno determinado.

Requisitos previos

• Un ordenador Windows con derechos de administrador local (o una herramienta de implementación que se ejecute como SYSTEM).
• .NET Framework 4.8 o posterior.
• El MSI de Devolutions Agent para la arquitectura de destino, x64 o arm64 (por ejemplo DevolutionsAgent-2026.3.0-x64.msi).

El instalador no permite cambiar a una versión anterior. Si ya hay instalada una versión más reciente, la instalación falla con el código de salida 1603.

Componentes del instalador

Cada componente del instalador corresponde a un id. de función. Utilice estos identificadores en ADDLOCAL (para instalar) o REMOVE (para quitar). Los id. de función distinguen entre mayúsculas y minúsculas.

Id. de función	Nombre en el instalador	Predeterminado	Descripción
F.Agent	Devolutions Agent	Instalado (obligatorio)	Instala el servicio Devolutions Agent. Siempre obligatorio. Elemento primario de F.Updater, F.Tunnel y F.PsuAgent.
F.Session	RDP Extension	Instalado	Habilita funciones de sesión RDP como la ejecución remota, las sesiones de salto y el cierre de sesión remoto. Obligatorio cuando el ordenador se usa como jump host.
F.Updater	Devolutions Gateway Updater	Instalado	El módulo de actualización de Devolutions Agent. Gestiona las actualizaciones de Devolutions Gateway y de Devolutions Cloud Services, así como la actualización automática de Devolutions Agent. Sin él, Devolutions Agent no puede actualizarse. No añade una sobrecarga apreciable, por lo que se recomienda conservarlo.
F.Tunnel	Agent Tunnel	No instalado	Conecta Devolutions Agent a un Devolutions Gateway. Una instalación silenciosa con este componente falla si no se pasan propiedades adicionales, como la cadena de inscripción del operador del gateway. No se trata en este artículo. Consulte Agent tunnel.
F.PsuAgent	PowerShell Universal Agent	No instalado	Habilita el agente remoto de PowerShell Universal. Experimental. Una instalación silenciosa con este componente falla si no se pasan propiedades adicionales, como la URL y el token de PowerShell Universal. No se trata en este artículo.
F.Pedm	Devolutions PEDM	No instalado	Habilita las funciones PEDM e instala la extensión del shell. Experimental.

Si ejecuta una instalación silenciosa sin ADDLOCAL, se instalan los componentes predeterminados: Devolutions Agent, RDP Extension y Devolutions Gateway Updater.

Instalación silenciosa

Componentes predeterminados

Para instalar Devolutions Agent con sus componentes predeterminados, ejecute el siguiente comando desde un símbolo del sistema con privilegios elevados:

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

Modificador	Finalidad
/i	Instalar o actualizar el paquete.
/qn	Sin interfaz de usuario (silencioso).
/norestart	No reiniciar el ordenador automáticamente.
/l*v <path>	Escribir un registro de instalación detallado. Recomendado para la solución de problemas.

Componentes seleccionados

Para elegir los componentes, pase ADDLOCAL con una lista de id. de función separados por comas. F.Agent debe incluirse siempre. Cualquier componente que no esté en la lista no se instala.

El ejemplo siguiente es una configuración típica para un jump host. Instala Devolutions Agent con RDP Extension y el módulo de actualización.

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"

El ejemplo siguiente instala Devolutions Agent con RDP Extension, sin el módulo de actualización. Utilícelo solo si su organización no quiere que Devolutions Agent se actualice a sí mismo ni a otros componentes de Devolutions.

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

Sin F.Updater, Devolutions Agent no puede actualizarse. Las actualizaciones deben implementarse entonces con sus propias herramientas.

No añada F.Tunnel ni F.PsuAgent a ADDLOCAL sin sus propiedades obligatorias. De lo contrario, la instalación silenciosa falla.

Actualizar una instalación existente

Cuando instala una versión más reciente sobre una existente sin ADDLOCAL, el instalador conserva los componentes que ya estaban instalados.

Cuando pasa ADDLOCAL, el instalador usa su lista en lugar de la anterior. Por tanto, el mismo comando puede usarse para instalaciones nuevas y para actualizaciones. Por ejemplo, actualizar con ADDLOCAL="F.Agent,F.Session" quita el módulo de actualización (F.Updater) si estaba instalado antes.

Pase siempre ADDLOCAL en su paquete de implementación. De este modo, todos los ordenadores acaban con los mismos componentes, independientemente de lo que hubiera instalado en ellos antes.

Quitar un componente de un Devolutions Agent instalado

Para quitar un componente de un Devolutions Agent instalado, ejecute el MSI de la versión instalada. Indique los componentes que conserva en ADDLOCAL y los que quita en REMOVE:

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

No utilice REMOVE por sí solo. Por ejemplo, REMOVE="F.Updater" por sí solo también desactiva RDP Extension. Esto solo surte efecto después del siguiente reinicio del servicio o del ordenador, por lo que el problema no se ve de inmediato.

Script de implementación de PowerShell

El script siguiente puede usarse tal cual, o como comando de instalación de una herramienta de implementación. Instala o actualiza Devolutions Agent, comprueba el código de salida e indica qué componentes están habilitados.

# 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

Para implementar en varios ordenadores desde una estación de trabajo de administración con la comunicación remota de PowerShell habilitada:

$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 copia desde un recurso compartido de red dentro de una sesión remota puede fallar por la delegación de credenciales (doble salto). Si ocurre, copie primero el MSI en los ordenadores de destino, o deje que su herramienta de implementación lo distribuya.

Códigos de salida

Código de salida	Significado
0	La instalación se realizó correctamente.
3010	La instalación se realizó correctamente. Es necesario reiniciar para completarla.
1641	La instalación se realizó correctamente y se inició un reinicio.
1603	Error grave durante la instalación. Consulte el registro detallado. Este es también el código que se devuelve cuando ya hay instalada una versión más reciente (el registro muestra "A newer version of this product is already installed.").
1618	Hay otra instalación en curso. Vuelva a intentarlo más tarde.

Comprobar la instalación

• Compruebe que el servicio Devolutions Agent está en ejecución con Get-Service DevolutionsAgent.
• Abra C:\ProgramData\Devolutions\Agent\agent.json. El instalador escribe un valor Enabled para cada componente opcional. Por ejemplo, con ADDLOCAL="F.Agent,F.Session", Session muestra "Enabled": true y Updater muestra "Enabled": false.
• Si algo no parece correcto, abra el registro de instalación detallado (el archivo /l*v). Enumera cada función y su estado de instalación.

Después de la instalación

No es necesario reiniciar ni cerrar la sesión después de instalar Devolutions Agent.

La comunicación entre Remote Desktop Manager y Devolutions Agent se realiza a través de la conexión RDP, y este canal se establece cuando se establece la conexión RDP. Si Devolutions Agent se instala mientras hay una sesión RDP abierta en ese ordenador, cierre esa sesión RDP y ábrala de nuevo. Las nuevas conexiones RDP realizadas después de la instalación funcionan de inmediato.

Las sesiones de salto, el cierre de sesión remoto y la ejecución remota necesitan RDP Extension (F.Session). Inclúyalo en ADDLOCAL en cada ordenador donde se usen estas funciones.

Desinstalación silenciosa

Para desinstalar Devolutions Agent de forma silenciosa, busque su código de producto y ejecute 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 desinstalación no quita C:\ProgramData\Devolutions\Agent (incluido agent.json) ni la clave del Registro HKLM\SOFTWARE\Devolutions\Agent. Elimínelos manualmente si necesita un estado limpio, por ejemplo antes de una reinstalación desde cero.

Véase también

• Jump host
• Devolutions Blog – Sustituir RDM Agent por Devolutions Agent