> ## Documentation Index
> Fetch the complete documentation index at: https://docsnewgen.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Windows

FlexxAgent para Windows permite la monitorización, gestión y automatización de dispositivos Windows desde la plataforma Flexxible.

Se distribuye como un único ejecutable que integra todos los componentes necesarios para su funcionamiento, por lo que no requiere la instalación previa de dependencias ni software adicional.

Este diseño simplifica los procesos de despliegue, actualización y mantenimiento, especialmente en entornos con un gran número de dispositivos gestionados.

## Compatibilidad

FlexxAgent es compatible con las versiones de Windows que se encuentran dentro del ciclo de soporte oficial de Microsoft:

* Microsoft Windows 10 o posterior.

* Microsoft Windows Server 2016 o posterior.

### Requisitos de arquitectura

FlexxAgent únicamente es compatible con sistemas operativos de 64 bits. No es posible su instalación en sistemas de 32 bits.

## Arquitectura

FlexxAgent se distribuye como un único ejecutable. Durante la instalación se configuran automáticamente los componentes necesarios para su ejecución tanto a nivel de sistema como de sesión de usuario.

Esta arquitectura facilita la administración del agente, simplifica las tareas de diagnóstico y reduce la complejidad operativa asociada a su mantenimiento.

<img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/univ-process.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=ab520005d2d094df35fef9ae5361c161" alt="univ-process" width="781" height="286" data-path="images/flexxagent/univ-process.png" />

## Consumo de recursos

FlexxAgent está optimizado para minimizar su impacto sobre el rendimiento del dispositivo. Los valores aproximados de consumo son los siguientes:

| Recurso          | Consumo aproximado |
| ---------------- | ------------------ |
| Espacio en disco | \< 300 MB          |
| CPU              | \< 0.5 %           |
| Memoria RAM      | 90 - 170 MB        |

## Descarga e instalación

1. Hacer clic en **Descargar FlexxAgent**, disponible en la parte inferior del menú lateral.
2. Seleccionar el grupo de reporte que se asociará al dispositivo.
3. Descargar el archivo de configuración `(.conf)` y el instalador para Windows.

   El sistema operativo puede bloquear los archivos descargados desde Internet. Si esto ocurre, será necesario desbloquearlos manualmente antes de iniciar la instalación.

   <img src="https://mintcdn.com/flexxible/zA3m6tfe7aHVcynj/images/flexxagent/agent-download.png?fit=max&auto=format&n=zA3m6tfe7aHVcynj&q=85&s=8315a7776e8bd6bcabd1e4b479a0ab2f" alt="agent-download" width="750" height="553" data-path="images/flexxagent/agent-download.png" />

## Tipos de instalador

Las opciones avanzadas permiten seleccionar el formato del instalador:

| Formato | Descripción                                                                          |
| ------- | ------------------------------------------------------------------------------------ |
| `.exe`  | Recomendado. Permite instalaciones mediante interfaz gráfica o de forma desatendida. |
| `.msi`  | Diseñado para instalaciones desatendidas y despliegues automatizados.                |

<img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/wizard6.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=d433d53fd65df88d3e250a8979451039" alt="wizard6" width="749" height="220" data-path="images/flexxagent/wizard6.png" />

## Instalación mediante interfaz gráfica

Para instalar FlexxAgent mediante interfaz gráfica:

1. Ejecutar el archivo `.exe` descargado.

2. Leer y aceptar el acuerdo de licencia.

   <img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/install_01-0.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=52d8cb0059cf6dfcb3067e023e54c290" alt="install_01-0" width="750" height="578" data-path="images/flexxagent/install_01-0.png" />

3. Seleccionar el archivo de configuración `(.conf)` descargado previamente.

   <img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/install_03-0.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=57cdfa63b3e83b834feef2cc31e3f015" alt="install_03-0" width="750" height="578" data-path="images/flexxagent/install_03-0.png" />

4. Hacer clic en **Instalar** para iniciar el proceso de instalación.

   <img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/install_04-0.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=908c5afa57d39bd19c7247b48a8607b5" alt="install_04-0" width="750" height="578" data-path="images/flexxagent/install_04-0.png" />

## Instalación desatendida

FlexxAgent permite realizar instalaciones desatendidas utilizando los archivos descargados.

* Instalador (`.exe` o `.msi`).
* Archivo de configuración (`.conf`).

### Instalación mediante EXE

#### Parámetros disponibles

| Parámetro        | Tipo     | Obligatorio | Descripción                                                                                                                                                             |
| ---------------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/AgentConfig`   | Cadena   | Sí          | En instalaciones con interfaz gráfica se solicitará el valor de configuración. Para reutilizar una configuración previa, indica `/UsePrevConfig=True`.                  |
| `/UsePrevConfig` | Booleano | No          | Cuando se establece en `True`, el instalador intenta reutilizar la configuración existente en el dispositivo. En este caso, no es necesario especificar `/AgentConfig`. |
| `/SendTelemetry` | Booleano | No          | Valor predeterminado: `False`.                                                                                                                                          |

#### Ejemplo

```powershell theme={null}
.\FlexxAgent.Installer.exe /verysilent /AgentConfig="C:\Path\To\Settings\settings.conf"
```

### Instalación mediante MSI

#### Parámetros disponibles

| Parámetro         | Tipo     | Obligatorio | Descripción                                                                                                                                                             |
| ----------------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AGENT_CONFIG`    | Cadena   | Sí          | Ruta absoluta del archivo de configuración (`.conf`). Si deseas reutilizar una configuración previa, indica `USE_PREV_CONFIG=True.`                                     |
| `USE_PREV_CONFIG` | Booleano | No          | Cuando se establece en `True`, el instalador intenta reutilizar la configuración existente en el dispositivo. En este caso, no es necesario especificar `AGENT_CONFIG`. |
| `SEND_TELEMETRY`  | Booleano | No          | Valor predeterminado: `False`.                                                                                                                                          |

### Opciones de `msiexec`

| Opción | Descripción                                                             |
| ------ | ----------------------------------------------------------------------- |
| `/i`   | Instala el paquete MSI especificado.                                    |
| `/qn`  | Ejecuta la instalación en modo silencioso, sin interacción del usuario. |

#### Ejemplo

```powershell theme={null}
msiexec /qn /i "C:\Path\To\Installer\FlexxAgent.Installer.msi" AGENT_CONFIG="C:\Path\To\Settings\settings.conf"
```

## Desinstalación

FlexxAgent puede desinstalarse manualmente desde el Panel de control del dispositivo.

Para realizar una desinstalación desatendida, se pueden utilizar los siguientes métodos.

### Desinstalación mediante EXE

```powershell theme={null}
"C:\Program Files\Flexxible\FlexxAgentUniversal\unins000.exe" /verysilent [/log="mi_fichero_de_log"]
```

### Desinstalación mediante MSI

```powershell theme={null}
msiexec /qn /passive /x "{6F330B47-2577-43AD-9095-18614A74D82F}"
```

## Prueba de conectividad

La prueba de conectividad permite verificar que FlexxAgent puede comunicarse correctamente con los servicios de Flexxible.

Para ejecutarla, es necesario disponer de permisos de administrador en el dispositivo.

### Pasos para ejecutar la prueba de conectividad

1. Abrir una consola con privilegios de administrador.

2. Acceder al directorio de instalación:

   ```powershell theme={null}
   cd "%ProgramFiles%\Flexxible\FlexxAgentUniversal"
   ```

3. Ejecutar el siguiente comando:

   ```powershell theme={null}
   FlexxAgent.Universal.exe connectivity
   ```

4. Revisar la información de diagnóstico mostrada en pantalla.

La salida incluirá información sobre el estado de la conectividad y posibles errores de comunicación con los servicios de Flexxible.

<img src="https://mintcdn.com/flexxible/JsQoT0tgTfYq-qwc/images/flexxagent/agent-conectivity.png?fit=max&auto=format&n=JsQoT0tgTfYq-qwc&q=85&s=1b1810628ebed51a23b9dea7815b8081" alt="agent-conectivity" width="1001" height="678" data-path="images/flexxagent/agent-conectivity.png" />

## Configuración de proxy

Si el entorno utiliza un servidor proxy para acceder a Internet, la configuración debe realizarse antes de instalar FlexxAgent.

Para ello, se debe modificar el archivo de configuración (`.conf`) descargado y añadir el parámetro `proxy` en la sección `[Agent/Network]`.

### Proxy sin autenticación

```ini theme={null}
proxy = http://proxy_uri:port
```

Ejemplo:

```ini theme={null}
proxy = http://192.168.0.100:443
```

### Proxy con autenticación

```ini theme={null}
proxy = http://user:password@proxy_uri:port
```

Ejemplo:

```ini theme={null}
proxy = http://proxy_user:xxxxxxxx@192.168.0.100:443
```

## Enlace mágico

<Note>
  Disponible únicamente en entornos FXXOne.
</Note>

El enlace mágico permite a los usuarios con el rol **Administrador de organización** en organizaciones de tipo socio distribuir el instalador de FlexxAgent sin necesidad de que los usuarios finales accedan o se autentiquen en la plataforma.

El enlace se genera desde la plataforma y puede compartirse con los usuarios para facilitar la descarga directa del agente en sus dispositivos.

### Crear un enlace mágico

1. Acceder a **Inicio** desde el menú de la plataforma.
2. Hacer clic en **Generar un enlace mágico**.

<img src="https://mintcdn.com/flexxible/fa81NqSTg_7uHzKB/images/flexxagent/magic-link.png?fit=max&auto=format&n=fa81NqSTg_7uHzKB&q=85&s=3136d1426ef3d5359159b6ab802ed76f" alt="magic-link" width="854" height="314" data-path="images/flexxagent/magic-link.png" />

3. Completar el formulario indicando:

   * El grupo de reporte asociado al enlace.
   * La plataforma para la que se requiere el instalador.
   * El número de días durante los que el enlace permanecerá activo.

   <img src="https://mintcdn.com/flexxible/fa81NqSTg_7uHzKB/images/flexxagent/magic-link-inst.png?fit=max&auto=format&n=fa81NqSTg_7uHzKB&q=85&s=f75d0585311b0b1da22f2bcadab46814" alt="magic-link-inst" width="1000" height="479" data-path="images/flexxagent/magic-link-inst.png" />

4. Hacer clic en **Nuevo**.

5. Copiar el enlace generado y hacer clic en **Aceptar**.

### Utilizar un enlace mágico

Para utilizar un enlace mágico, basta con copiarlo y pegarlo en la barra de direcciones de un navegador web.

Al acceder al enlace, se iniciará la descarga del instalador y se mostrará una página de confirmación.

<img src="https://mintcdn.com/flexxible/Bu8f4dI-plc_yf8g/images/flexxagent/magic-ling-downloaded.png?fit=max&auto=format&n=Bu8f4dI-plc_yf8g&q=85&s=0a390aaad684cc08e8d20a7e820c6bdb" alt="magic-ling-downloaded" width="854" height="380" data-path="images/flexxagent/magic-ling-downloaded.png" />

### Revocar un enlace mágico

1. Acceder a **Configuración** → **Grupos de reporte**.
2. En la columna **Acción** del grupo de reporte, seleccionar la opción **Revocar**.
3. Confirmar la acción haciendo clic en **Aceptar**.

Una vez revocado o caducado, un enlace mágico no puede volver a utilizarse.
