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

# Desplegar FlexxAgent vía políticas de grupo (GPO)

> Guía para deplegar el agente de forma desatendida utilizando GPOs

FlexxAgent puede desplegarse en Windows utilizando directivas de grupo (GPO). Para ello se necesita tener acceso al paquete de instalación del agente, que se puede descargar desde el portal de Flexxible.

## Despliegue

1. Crear un script de Powershell llamado `.Install.ps1` con el siguiente contenido:
   Start-Process `Ruta al fichero\FlexxAgent-Installer.exe` /verysilent /AgentConfig="`Ruta al fichero\settings.conf`"

   Ejemplo:

   ```
   Start-Process C:\Temp\FlexxAgent-Installer\FlexxAgent-Installer.exe /verysilent /AgentConfig="C:\Temp\FlexxAgent-Installer\settings.conf"
   ```

<Note>
  Asegurarse de que, aparte del ejecutable, la línea incluye los parámetros necesarios para la instalación, como por ejemplo el proxy, en caso de ser necesario.
</Note>

2. Guardar el fichero para su uso posterior.
3. Ejecutar la consola de gestión de políticas de grupo de Windows en un controlador de dominio que tenga instaladas las herramientas de gestión remota de equipos.
4. Crear una nueva política de grupo dentro del contenedor de políticas de grupo.
   <img src="https://mintcdn.com/flexxible/X87eAETtm8nG0tMl/images/guides/0depgpo.png?fit=max&auto=format&n=X87eAETtm8nG0tMl&q=85&s=7abcb3568f77c942d4d9510a9605a6b9" alt="0depgpo" width="458" height="358" data-path="images/guides/0depgpo.png" />
5. Darle un nombre a la nueva directiva. Elegir uno que sea significativo.
6. Pulsar con el botón derecho del ratón sobre la directiva de grupo y seleccionar `Editar`.
7. Expandir el árbol `Computer Configuration` -> `Windows Settings` y seleccionar `Scripts (Startup/Shutdown)`
   <img src="https://mintcdn.com/flexxible/X87eAETtm8nG0tMl/images/guides/1depgpo.png?fit=max&auto=format&n=X87eAETtm8nG0tMl&q=85&s=ddec9a5f00b41e1c1a64b66a7188a40a" alt="1depgpo" width="739" height="166" data-path="images/guides/1depgpo.png" />
8. Aparecerá un diálogo en una ventana nueva. En ella seleccionar `PowerShell Scripts`. A continuación, clicar en el botón `Show Files…`
   <img src="https://mintcdn.com/flexxible/X87eAETtm8nG0tMl/images/guides/3depgpo.png?fit=max&auto=format&n=X87eAETtm8nG0tMl&q=85&s=cb09c98ab5beb9e3a01063719ae22746" alt="2depgpo" width="854" height="182" data-path="images/guides/3depgpo.png" />
9. Se abrirá la carpeta de red en la que se almacenan los scripts para la política de grupo.
   <img src="https://mintcdn.com/flexxible/X87eAETtm8nG0tMl/images/guides/3depgpo.png?fit=max&auto=format&n=X87eAETtm8nG0tMl&q=85&s=cb09c98ab5beb9e3a01063719ae22746" alt="3depgpo" width="854" height="182" data-path="images/guides/3depgpo.png" />
10. Copiar el fichero `Install.ps1` que se creó al principio y pegarlo dentro de la carpeta de red de almacenamiento de los scripts de la política de grupos.
    <img src="https://mintcdn.com/flexxible/X87eAETtm8nG0tMl/images/guides/4depgpo.png?fit=max&auto=format&n=X87eAETtm8nG0tMl&q=85&s=e84a5bb816a4810957d702f39afbf985" alt="4depgpo" width="657" height="171" data-path="images/guides/4depgpo.png" />
11. Cerrar el explorador de Windows que daba acceso a la carpeta con los scripts de la directiva de grupo.
12. Se volverá a ver la ventana modal de las propiedades del script de arranque. Clicar en el botón `Add…`.
13. Aparecerá un diálogo para seleccionar ficheros. Buscar el script a utilizar usando el botón `Browse…`.
14. Se abrirá la ruta anterior, en la que estará el fichero creado al principio del procedimiento. Hacer doble clic sobre él o seleccionarlo y clicar en el botón `Open`.
15. Una vez seleccionado el fichero, seleccionar Ok para cerrar el diálogo. El fichero aparecerá en la ventana modal de configuración.
16. Seleccionar `OK` para cerrar esta ventana. Se volverá al editor de políticas de grupo. Esta ventana se puede cerrar.
17. Buscar la rama de la organización, dentro del controlador de dominio en la que se encuentren los dispositivos en los que se quiere instalar FlexxAgent. Seleccionar la rama y pulsar en ella con el botón derecho del ratón. `Seleccionar Link an Existing GPO`.
    <img src="https://mintcdn.com/flexxible/X87eAETtm8nG0tMl/images/guides/5depgpo.png?fit=max&auto=format&n=X87eAETtm8nG0tMl&q=85&s=5f9cad6d88dfcc8c9f69e862c7bc4ef2" alt="5depgpo" width="514" height="245" data-path="images/guides/5depgpo.png" />
18. Aparecerá un diálogo de selección en el que se seleccionará la directiva creada anteriormente. Una vez seleccionada, clicar en OK.

## Comprobación

Para validar la instalación de FlexxAgent en un equipo del dominio, es necesario reiniciar al menos uno de los dispositivos dentro del mismo, con el fin de que la política de grupo tenga vigencia.

Después del reinicio, se debe acceder al Visor de eventos, en la sección Registro de aplicaciones, donde se podrán consultar los eventos generados durante la instalación y la primera ejecución de FlexxAgent.

<img src="https://mintcdn.com/flexxible/X87eAETtm8nG0tMl/images/guides/6depgpo.png?fit=max&auto=format&n=X87eAETtm8nG0tMl&q=85&s=cfff9c7f84e1da2ed8466b1b2505c8fd" alt="6depgpo" width="626" height="438" data-path="images/guides/6depgpo.png" />

Tras unos minutos, se podrá ver el nuevo dispositivo registrado en el módulo Workspaces y en la vista de `Workspaces` de Portal.

<img src="https://mintcdn.com/flexxible/X87eAETtm8nG0tMl/images/guides/7depgpo.png?fit=max&auto=format&n=X87eAETtm8nG0tMl&q=85&s=2c434ff109d6c4ccbf8d2498d4257f7f" alt="7depgpo" width="999" height="450" data-path="images/guides/7depgpo.png" />

El registro de instalación puede verse de forma detallada en el fichero `C:\Windows\Temp\FlexxAgentInstallation.log`.

<img src="https://mintcdn.com/flexxible/X87eAETtm8nG0tMl/images/guides/8depgpo.png?fit=max&auto=format&n=X87eAETtm8nG0tMl&q=85&s=3143bb1f162e15f08e5c6463192a4f5e" alt="8depgpo" width="600" height="480" data-path="images/guides/8depgpo.png" />
