Windows
FlexxAgent soporta sistemas operativos Windows de 64 bits, no es posible instalarlo en sistemas de 32 bits. El binario de instalación está disponible con o sin interfaz gráfica, por lo que es compatible tanto con métodos de despliegue desatendido, como con la instalación mediante asistente.

Arquitectura del servicio
FlexxAgent se compone de un servicio de Windows denominado FlexxAgent Service, que coordina dos procesos:
- FlexxAgent, ejecutado a nivel sistema
- FlexxAgent Analyzer, iniciado para cada sesión de usuario.
Esta arquitectura permite que FlexxAgent gestione dispositivos con múltiples sesiones (como servidores de terminal, Citrix o AVD) y obtenga métricas detalladas para mejorar las capacidades de diagnóstico.
Ejemplo:
- En un portátil, se ejecutan FlexxAgent (a nivel de sistema) y FlexxAgent Analyzer (bajo la identidad del usuario).
- En un dispositivo con múltiples sesiones, además de FlexxAgent, se ejecutará un proceso FlexxAgent Analyzer por cada sesión.
Consumos
FlexxAgent está optimizado para minimizar el uso de recursos. Los valores aproximados son:
- Espacio en disco: < 200 MB
- CPU: < 0.5%
- RAM: 100-200 MB
Proceso FlexxAgent (sistema)
- Recolección de información de rendimiento, hardware, sesiones, perfiles, discos, particiones y servicios de Windows: cada 60 segundos.
- Envío de eventos de error del registro de eventos: cada 10 minutos.
- Actualización de información de perfiles de usuario: cada 15 minutos.
Proceso FlexxAgent Analyzer (usuario)
- Analiza el uso de aplicaciones, datos de diagnóstico y experiencia de usuario.
- Recolección local de datos: cada 15 segundos.
- Envío de reportes al servicio: cada 5 minutos (esta métrica puede cambiar en funcionalidades específicas).
Versiones soportadas
FlexxAgent es compatible con los sistemas operativos Windows actualmente en ciclo de soporte por Microsoft. Aunque puede instalarse en versiones sin soporte, algunas funcionalidades podrían no estar disponibles.
Compatibilidad completa
- Microsoft Windows 10 o posterior
- Microsoft Windows Server 2016 o posterior
Compatibilidad limitada
- Windows 7 SP1
- Windows 8.1 SP1
- Windows Server 2008 R2 SP1
- Windows Server 2012
Requisitos de software
FlexxAgent requiere los siguientes componentes:
- .NET Framework 4.6.2 o posterior (recomendado: .NET Framework 4.8).
- Windows PowerShell 4.0 o posterior (recomendado PowerShell 5.1).
- Nota: La política de ejecución de Azure PowerShell debe establecerse en Sin restricciones.
Consideraciones para versiones de Windows en EOL
En sistemas fuera de soporte (EOL), FlexxAgent puede presentar limitaciones o falta de compatibilidad con determinadas funcionalidades.
Funcionalidades no soportadas
Cuando se utiliza FlexxAgent en sistemas operativos Windows antiguos que están fuera de soporte, no se admiten las siguientes funcionalidades:
- Recopilación de métricas de consumo de GPU.
- Ejecución de flujos.
- Ejecución de microservicios por el usuario final.
- Obtención de información de las unidades de almacenamiento.
- En el caso de dispositivos virtuales, detección de broker e hipervisor (limitada según proveedor).
- User Input Delay (UID) (solo disponibles a partir de Windows Server 2019 y Windows 10 versión 1809).
La detección de intermediarios puede no funcionar para todos. No hay datos de rendimiento de retraso de entrada del usuario, ya que este contador no existe en Windows 7 o Windows Server 2008 R2.
Windows 7 y 2008 R2
FlexxAgent puede instalarse en Windows 7 x64 o Windows Server 2008 R2 SP1 bajo las siguientes condiciones:
- Instalar la actualización KB4474419: (SHA-2 code signing support update for Windows Server 2008 R2, Windows 7, and Windows Server 2008: September 23, 2019).
- Instalar la actualización KB3140245: (Update to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows) y seguir las instrucciones de la sección How to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows de la página de soporte de Microsoft.
- Requiere al menos .NET Framework 4.6 (recomendado: 4.8).
- PowerShell 2.0 con Windows 7 no es compatible con TLS 1.2; instalar Windows Management Framework 5.1, que incluye PowerShell 5.1.
Windows 8 y 2012
La instalación de FlexxAgent soporta Windows 8 bajo las siguientes condiciones:
- Requiere .NET Framework 4.6.2 (Microsoft bloquea la instalación de versiones posteriores en Windows 8.0).
- Deben aplicarse todas las actualizaciones de seguridad de Windows para garantizar la compatibilidad con TLS 1.2 y la firma de código SHA-2.
Descarga
BINARIO SIN INTERFAZ GRÁFICA
Pasos para realizar la descarga:
-
Acceder a
Workspaces->Nivel 2->Grupos de reporte. -
En vista de lista, seleccionar el grupo de reporte sobre el que se desea descargar el agente y hacer clic en
Descargar FlexxAgent.

- Se abrirá una ventana con la opción
Generate standalone installer (offline), para descargar el instalador de FlexxAgent:

-
Si se selecciona la opción: durante la instalación, el binario no requerirá acceso a internet para la comprobación o descarga de binarios.
-
Si no se selecciona: se descargará el paquete de instalación mínimo, que accederá a internet para obtener los binarios más recientes.
Despliegue desatendido
FlexxAgent admite despliegue desatendido mediante GPOs, Intune, SCCM, u otras herramientas de distribución.
Instalación
La instalación de FlexxAgent de forma desatendida se realiza mediante PowerShell.
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "<agregar parámetro>" -WindowStyle Hidden -Wait
Parámetros admitidos
| Parámetro | Tipo | Descripción |
|---|---|---|
| proxyAbsoluteUri | [string] | URL y puerto del proxy. |
| proxyUser | [string] | User para proxy autenticado. |
| proxyPass | [string] | Password para proxy autenticado. |
| proxyPersistConfig | [switch] | Si se especifica, se persiste la configuración en el registro. |
| configFilePath | [string] | Directorio alternativo para el archivo FlexxAgent-Configuration.conf. |
| DebugMode | [switch] | Cuando se especifica, crea un archivo de texto en la misma carpeta con la transcripción de la ejecución del script. |
| RepairAgent | [bool] | Elimina la configuración preexistente de FlexxAgent cuando se reinstala en un dispositivo. |
| Help | [switch] | Lista los parámetros admitidos, con tipo y descripción. |
Desinstalación
Para desinstalar FlexxAgent de forma desatendida:
"C:\Program Files\Flexxible\FlexxAgent\VDIServiceUpdater.exe" /Uninstall "C:\Program Files\Flexxible\FlexxAgent\FlexxAgent.exe" /quiet
El instalador de Windows no elimina todos los archivos, carpetas, claves o valores de registro creados durante la instalación. Para una imagen limpia del sistema, puede eliminar manualmente:
Archivos
C:\Windows\Prefetch\FLEXXAGENT.EXE-XXXXXXXX.pf– donde XXXXXXXX es una cadena de letras y númerosC:\Windows\Temp\FlexxAgentInstallation.log
Carpetas
C:\Program Files\FlexxibleC:\ProgramData\Flexxible
Reinstalación
Para reinstalar FlexxAgent en un dispositivo eliminando su configuración previa se debe ejecutar:
FlexxAgent-Installer.exe -repairAgent
Por ejemplo:
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "-repairAgent true" -WindowStyle Hidden -Wait
Protección contra la desinstalación
Esta funcionalidad impide que un usuario desinstale FlexxAgent. La configuración puede aplicarse a nivel de Producto o Grupo de reporte.
Requisitos
- La configuración solo puede realizarla un usuario con rol Administrador de organización.
- Versión mínima de FlexxAgent: 25.4.2.
Esta funcionalidad está deshabilitada por defecto.
Configuración a nivel de Producto
- Acceder a
Portal->Configuración->Organización. - En el menú, seleccionar la pestaña
Productos. - En la tabla, elegir el entorno sobre el que se desea ejecutar la funcionalidad, y en el campo
Acciónhacer clic sobreConfiguración del agente. - En el formulario, habilitar o deshabilitar el botón
Protección de desinstalación. - Hacer clic en
Guardar.
Configuración a nivel de Grupos de reporte
La ejecución de la funcionalidad puede hacerse sobre uno o varios grupos de reporte.
Habilitar la protección a un grupo de reporte
- Acceder a
Portal->Configuración->Grupos de reporte. - En la tabla, elegir el grupo de reporte sobre el que se desea ejecutar la funcionalidad, y en el campo
Acciónhacer clic sobreConfiguración del agente. - En el formulario, editar la funcionalidad
Protección de desinstalación(botón con forma de lápiz) para poder elegir entre habilitarla o deshabilitarla. - Hacer clic en
Guardar.
Los grupos de reporte heredan la configuración que se hace a nivel de Producto; no obstante, pueden sobrescribir su propia configuración.

Habilitar la protección a varios grupos de reporte
- Acceder a
Portal->Configuración->Grupos de reporte. - En la tabla, seleccionar los grupos de reporte sobre los que se desea ejecutar la funcionalidad.
- Hacer clic en
Editar protección de desinstalación. Se desplegarán tres opciones:
- Habilitar protección de desinstalación. Protege a los grupos de reporte contra la desinstalación de FlexxAgent (esta opción no estará disponible si la funcionalidad ya está habilitada en Producto).
- Deshabilitar protección de desinstalación. Permite a los usuarios desinstalar FlexxAgent (esta opción no estará disponible si la funcionalidad ya está deshabilitada en Producto).
- Restablecer protección de desinstalación. plica la configuración que tenga el Producto al que pertenece el grupo de reporte, sea habilitada o deshabilitada.

Un dispositivo tendrá habilitada la Protección contra la desinstalación de FlexxAgent en los siguientes casos:
- La funcionalidad está habilitada en el grupo de reporte al que pertenece.
- La funcionalidad está desactivada en el grupo de reporte (no está habilitada ni deshabilitada), pero está habilitada a nivel Producto.
Formas de desinstalar FlexxAgent con la protección habilitada
Si un usuario tiene habilitada la funcionalidad, pero necesita desinstalar FlexxAgent, tendrá dos opciones:
- Mover el dispositivo a un grupo de reporte que no tenga la protección habilitada.
- A través de un token:
- Ir a
Portal->Workspacesy seleccionar el dispositivo. - Ejecutar la acción
Reveal uninstall tokenque mostrará un token único para ese dispositivo y que será válido hasta las 23:59:59 UTC del día siguiente. - Ir al Panel de Control de Windows y desinstalar FlexxAgent introduciendo el token.

Antes de gestionar la desinstalación de FlexxAgent a través de herramientas como Intune o scripts propios, se deben mover los dispositivos deseados a un grupo de reporte que no tenga habilitada la protección.
Flexxible recomienda tener un grupo de reporte con la Protección contra la desinstalación deshabilitada para facilitar tareas de desinstalación de FlexxAgent en los dispositivos.
Problemas conocidos
Instalación de FlexxAgent
Problema 1 - Windows Management Instrumentation (WMI)
Si el dispositivo tiene problemas generados por el servicio Windows Management Instrumentation (WMI) durante la instalación o reinstalación, es posible que el proceso reporte estos errores en la ventana de CMD:

Solución
Ejecutar los siguientes comandos:
Stop-Service winmgmt -Force
winmgmt /resetrepository
Start-Service winmgmt
Problema 2 - Restricción de procesos PowerShell
Algunas soluciones de seguridad no permiten que la instalación y/o autoactualización de FlexxAgent se realice de forma eficaz. El instalador podría devolver el mensaje:
The process was terminated with errors. A corrupted installation was detected due to external processes. This is usually caused by antivirus activity. Please check your antivirus settings.
Solución
Excluir los siguientes archivos:
C:\Windows\Temp\FlexxibleIT
C:\Windows\Temp\UpdateFlexxAgent.ps1
Desinstalación de FlexxAgent
Problema - FlexxAgent continúa en la lista de servicios
Podría suceder que FlexxAgent siga apareciendo en la lista de servicios, aunque se haya desinstalado y se hayan borrado todos los ficheros. Esto provocaría que no se pueda volver a instalar.
Solución
Ejecutar como administrador el siguiente comando en la ventana de CMD:
sc delete "FlexxAgent service"
A continuación, reiniciar el dispositivo.
Configuración de proxy
FlexxAgent admite proxies configurados de forma transparente a nivel de sistema, con o sin autenticación. La configuración del proxy puede realizarse por línea de comandos o mediante la modificación de claves de registro.
Configuración de proxy mediante línea de comandos
Instalación con parámetros:
FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyPersistConfig:$True
Donde ip.ad.dre.ss:port corresponde a la IP o DNS y el puerto del proxy.
O incluyendo credenciales:
FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyUser ProxyUserName -proxyPass ProxyUserPassword -proxyPersistConfig:$True
Puede que FlexxAgent no tenga acceso al proxy que tiene aplicado en su configuración si está fuera de la red corporativa. Para determinar su accesibilidad, FlexxAgent intenta resolver el registro DNS y realiza una petición TCP al puerto correspondiente. Si el proxy no es accesible, FlexxAgent lo reportará de manera directa (sin proxy).
Configuración de proxy mediante claves de registro
Las claves de registro que almacenan la configuración del proxy se encuentran en:
Equipo\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications
Claves de registro relativas a la configuración proxy:
Clave Proxy_URL
- Ruta:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Nombre: Proxy_URL
- Tipo: REG_SZ
- Valores admitidos: la URL y el puerto; por ejemplo
http://192.168.1.1:3128ohttps://192.168.1.1:3128
Clave Proxy_User
- Ruta:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Nombre: Proxy_User
- Tipo: REG_SZ
- Valores admitidos: el nombre de usuario para autenticarse en el proxy; por ejemplo
Administrador. Puede omitirse para proxies no autenticados.
Clave Proxy_Pwd
- Ruta:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Nombre: Proxy_Pwd
- Tipo: REG_SZ
- Valores admitidos: La contraseña para autenticarse en el proxy. Puede omitirse para proxies no autenticados.
El valor de la clave Proxy_Pwd puede establecerse en texto sin formato (no recomendado) o codificado en base64 y encerrado por «&&&».
Por ejemplo: &&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&& para el valor “Proxy_Pwd”.
En cualquiera de los dos casos, FlexxAgent cifra el valor en cuanto se inicia o intenta transmitir información. Puedes generar una cadena codificada en Base64 desde https://www.base64encode.org/.
Dado que que FlexxAgent desencadena un proceso a nivel de sistema (FlexxAgent.exe) y otro a nivel de sesión (FlexxAgent Analyzer.exe) puede ser necesario definir tipos de proxy diferentes para cada uno, dependiendo de cómo actúe el proxy a un nivel u otro.
Se puede definir el Tipo de proxy desde la Configuración de FlexxAgent, en Productos.
Actualización manual
Para actualizar FlexxAgent manualmente:
- Acceder a
Workspaces->Nivel 1->Workspaces->Operaciones->FlexxAgent->Actualizar FlexxAgent.

-
Se pueden consultar las versiones instaladas desde
Mis filtros->Filtros predefinidos->FlexxAgent version summary. Esto mostrará una vista de todos los dispositivos agrupados por versión. -
Una vez ejecutada la operación de actualización, se generará un trabajo con todos los detalles de la operación.
Logs
Los logs proporcionan información y permiten diagnosticar problemas durante la instalación.