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

# Implantar o FlexxAgent por meio de políticas de grupo (GPO)

> Guia para implantar o agente de forma não assistida usando GPOs

O FlexxAgent pode ser implantado no Windows usando políticas de grupo (GPO). Para isso, é necessário ter acesso ao pacote de instalação do agente, que pode ser baixado no portal da Flexxible.

## Implantação

1. Crie um script do PowerShell chamado `.Install.ps1` com o seguinte conteúdo:
   Start-Process `Caminho para o arquivo\FlexxAgent-Installer.exe` /verysilent /AgentConfig="`Caminho para o arquivo\settings.conf`"

   Exemplo:

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

<Note>
  Certifique-se de que, além do executável, a linha inclua os parâmetros necessários para a instalação, como o proxy, caso seja necessário.
</Note>

2. Salve o arquivo para uso posterior.
3. Execute o Console de Gerenciamento de Políticas de Grupo do Windows em um controlador de domínio que tenha as ferramentas de gerenciamento remoto de computadores instaladas.
4. Crie uma nova política de grupo dentro do contêiner 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. Dê um nome à nova diretiva. Escolha um nome que seja significativo.
6. Clique com o botão direito do mouse sobre a política de grupo e selecione `Editar`.
7. Expanda a árvore `Computer Configuration` -> `Windows Settings` e selecione `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. Uma caixa de diálogo será exibida em uma nova janela. Nela, selecione `PowerShell Scripts`. Em seguida, clique no botão `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. Será aberta a pasta de rede em que os scripts da política de grupo são armazenados.
   <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. Copie o arquivo `Install.ps1` que foi criado no início e cole-o dentro da pasta de rede de armazenamento dos scripts da política de grupo.
    <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. Feche o Windows Explorer que dava acesso à pasta com os scripts da diretiva de grupo.
12. Você verá novamente a janela modal das propriedades do script de inicialização. Clique no botão `Add…`.
13. Será exibida uma caixa de diálogo para selecionar arquivos. Procure o script a ser utilizado usando o botão `Browse…`.
14. Será aberto o caminho anterior, no qual estará o arquivo criado no início do procedimento. Dê um duplo clique nele ou selecione-o e clique no botão `Open`.
15. Uma vez selecionado o arquivo, selecione OK para fechar a caixa de diálogo. O arquivo aparecerá na janela modal de configuração.
16. Selecione `OK` para fechar essa janela. Você retornará ao editor de políticas de grupo. Essa janela pode ser fechada.
17. Localize o ramo da organização, dentro do controlador de domínio, no qual estão os dispositivos em que se deseja instalar o FlexxAgent. Selecione o ramo e clique nele com o botão direito do mouse. `Selecione 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á uma caixa de diálogo de seleção na qual você selecionará a diretiva criada anteriormente. Depois de selecionada, clique em OK.

## Verificação

Para validar a instalação do FlexxAgent em um computador do domínio, é necessário reiniciar pelo menos um dos dispositivos dentro dele, para que a política de grupo entre em vigor.

Após a reinicialização, acesse o Visualizador de Eventos, na seção Registro de Aplicações, onde é possível consultar os eventos gerados durante a instalação e a primeira execução do 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" />

Após alguns minutos, será possível ver o novo dispositivo registrado no módulo Workspaces e na visualização `Workspaces` do 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" />

O log de instalação pode ser visualizado em detalhes no arquivo `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" />
