> 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/es/deploy-devolutions-agent-silently.md).

# Desplegar Devolutions Agent de forma silenciosa

Despliegue Devolutions Agent de forma silenciosa con msiexec o PowerShell, y elija qué componentes instalar con la propiedad ADDLOCAL para una implementación masiva.

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](https://docs.devolutions.net/rdm/es/ribbon-menu-bar/tools/all-tools/rdm-jump-deprecated) obsoleto por Devolutions Agent en [jump hosts](/agent/es/jump-host.md), 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`).

{% hint style="warning" %}
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`.
{% endhint %}

## 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. Las mismas funciones, tal como se muestran en el instalador interactivo, se describen en [Devolutions Agent](/agent/es/readme.md#installation).

| 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. Instala el componente que abre el canal virtual RDP que Remote Desktop Manager utiliza para comunicarse con Devolutions Agent. Obligatorio para las conexiones Jump desde Remote Desktop Manager a través de Devolutions Agent y, por tanto, en cada 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.                                                                                                                              |
| `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](https://docs.devolutions.net/gateway/es/knowledge-base/knowledge-base-articles/agent-tunnel).                   |
| `F.PsuAgent`   | PowerShell Universal Agent  | No instalado            | Habilita el agente remoto de PowerShell Universal. 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.                                                                                                                                                                                                                                                                                                    |

{% hint style="info" %}
Si ejecuta una instalación silenciosa sin `ADDLOCAL`, se instalan los componentes predeterminados: Devolutions Agent, RDP Extension y Devolutions Gateway Updater.
{% endhint %}

## 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"
```

{% hint style="warning" %}
Sin `F.Updater`, Devolutions Agent no puede actualizarse. Las actualizaciones deben implementarse entonces con sus propias herramientas.
{% endhint %}

{% hint style="info" %}
No añada `F.Tunnel` ni `F.PsuAgent` a `ADDLOCAL` sin sus propiedades obligatorias. De lo contrario, la instalación silenciosa falla.
{% endhint %}

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

{% hint style="success" %}
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.
{% endhint %}

### 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"
```

{% hint style="warning" %}
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.
{% endhint %}

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

```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
```

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

```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 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.
{% endhint %}

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

{% hint style="warning" %}
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.
{% endhint %}

## Desinstalación silenciosa

Para desinstalar Devolutions Agent de forma silenciosa, busque su código de producto y ejecute `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 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.
{% endhint %}

## Véase también

* [Jump host](/agent/es/jump-host.md)
* [Devolutions Blog – Sustituir RDM Agent por 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/es/deploy-devolutions-agent-silently.md?ask=<question>&goal=<user_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.