Windows
FlexxAgent suporta sistemas operacionais Windows de 64 bits, não é possível instalá-lo em sistemas de 32 bits. O binário de instalação está disponível com ou sem interface gráfica, tornando-o compatível tanto com métodos de implantação desatendida quanto com a instalação através de assistente.

Arquitetura do serviço
FlexxAgent é composto por um serviço do Windows chamado FlexxAgent Service, que coordena dois processos:
- FlexxAgent, executado ao nível do sistema
- FlexxAgent Analyzer, iniciado para cada sessão de usuário.
Essa arquitetura permite que o FlexxAgent gerencie dispositivos com múltiplas sessões (como servidores de terminal, Citrix ou AVD) e obtenha métricas detalhadas para melhorar as capacidades de diagnóstico.
Exemplo:
- Em um laptop, são executados FlexxAgent (ao nível do sistema) e FlexxAgent Analyzer (sob a identidade do usuário).
- Em um dispositivo com múltiplas sessões, além do FlexxAgent, será executado um processo FlexxAgent Analyzer por sessão.
Consumos
FlexxAgent está otimizado para minimizar o uso de recursos. Os valores aproximados são:
- Espaço em disco: < 200 MB
- CPU: < 0.5%
- RAM: 100-200 MB
Processo FlexxAgent (sistema)
- Recolha de informação de desempenho, hardware, sessões, perfis, discos, partições e serviços do Windows: a cada 60 segundos.
- Envio de eventos de erro do log de eventos: a cada 10 minutos.
- Atualização de informações de perfis de usuário: a cada 15 minutos.
Processo FlexxAgent Analyzer (usuário)
- Analisa o uso de aplicativos, dados de diagnóstico e experiência do usuário.
- Recolha local de dados: a cada 15 segundos.
- Envio de relatórios ao serviço: a cada 5 minutos (essa métrica pode mudar em funcionalidades específicas).
Versões suportadas
FlexxAgent é compatível com os sistemas operacionais Windows atualmente em ciclo de suporte pela Microsoft. Embora possa ser instalado em versões sem suporte, algumas funcionalidades podem não estar disponíveis.
Compatibilidade completa
- Microsoft Windows 10 ou posterior
- Microsoft Windows Server 2016 ou posterior
Compatibilidade limitada
- Windows 7 SP1
- Windows 8.1 SP1
- Windows Server 2008 R2 SP1
- Windows Server 2012
Requisitos de software
FlexxAgent requer os seguintes componentes:
- .NET Framework 4.6.2 ou posterior (recomendado: .NET Framework 4.8).
- Windows PowerShell 4.0 ou posterior (recomendado PowerShell 5.1).
- Nota: A política de execução do Azure PowerShell deve ser definida como Sem restrições.
Considerações para versões do Windows em EOL
Em sistemas fora de suporte (EOL), o FlexxAgent pode apresentar limitações ou falta de compatibilidade com determinadas funcionalidades.
Funcionalidades não suportadas
Ao usar o FlexxAgent em sistemas operacionais Windows antigos que estão fora de suporte, as seguintes funcionalidades não são admitidas:
- Coleta de métricas de consumo de GPU.
- Execução de fluxos.
- Execução de microsserviços pelo usuário final.
- Obtenção de informações das unidades de armazenamento.
- No caso de dispositivos virtuais, detecção de broker e hipervisor (limitada conforme o fornecedor).
- User Input Delay (UID) (disponível apenas a partir do Windows Server 2019 e Windows 10 versão 1809).
A detecção de intermediários pode não funcionar para todos. Não há dados de desempenho de atraso de entrada do usuário, já que este contador não existe no Windows 7 ou Windows Server 2008 R2.
Windows 7 e 2008 R2
FlexxAgent pode ser instalado em Windows 7 x64 ou Windows Server 2008 R2 SP1 sob as seguintes condições:
- Instalar a atualização KB4474419: (atualização de suporte à assinatura de código SHA-2 para Windows Server 2008 R2, Windows 7 e Windows Server 2008: 23 de setembro de 2019).
- Instalar a atualização KB3140245: (Atualização para habilitar TLS 1.1 e TLS 1.2 como protocolos seguros padrão no WinHTTP no Windows) e seguir as instruções da seção Como habilitar TLS 1.1 e TLS 1.2 como protocolos seguros padrão no WinHTTP no Windows na página de suporte da Microsoft.
- Requer pelo menos .NET Framework 4.6 (recomendado: 4.8).
- PowerShell 2.0 com Windows 7 não é compatível com TLS 1.2; instalar Windows Management Framework 5.1, que inclui PowerShell 5.1.
Windows 8 e 2012
A instalação do FlexxAgent suporta Windows 8 sob as seguintes condições:
- Requer .NET Framework 4.6.2 (A Microsoft bloqueia a instalação de versões posteriores no Windows 8.0).
- Todas as atualizações de segurança do Windows devem ser aplicadas para garantir a compatibilidade com TLS 1.2 e a assinatura de código SHA-2.
Descarga
BINÁRIO SEM INTERFACE GRÁFICA
Passos para realizar o download:
-
Acessar
Workspaces->Nível 2->Grupos de relatórios. -
Em vista de lista, selecionar o grupo de relatório sobre o qual deseja baixar o agente e clicar em
Baixar FlexxAgent.

- Uma janela será aberta com a opção
Gerar instalador autônomo (offline), para baixar o instalador do FlexxAgent:

-
Se a opção for selecionada: durante a instalação, o binário não exigirá acesso à internet para a verificação ou download de binários.
-
Se não for selecionada: será baixado o pacote de instalação mínimo, que acessará a internet para obter os binários mais recentes.
Implantação autônoma
FlexxAgent suporta implantação desatendida via GPOs, Intune, SCCM, ou outras ferramentas de distribuição.
Instalação
A instalação do FlexxAgent de forma desatendida é realizada através do PowerShell.
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "<agregar parámetro>" -WindowStyle Hidden -Wait
Desinstalar
Para desinstalar o FlexxAgent de forma desatendida:
"C:\Program Files\Flexxible\FlexxAgent\VDIServiceUpdater.exe" /Uninstall "C:\Program Files\Flexxible\FlexxAgent\FlexxAgent.exe" /quiet
O instalador do Windows não remove todos os arquivos, pastas, chaves ou valores de registro criados durante a instalação. Para uma imagem limpa do sistema, você pode remover manualmente:
Arquivos
C:\Windows\Prefetch\FLEXXAGENT.EXE-XXXXXXXX.pf– onde XXXXXXXX é uma sequência de letras e númerosC:\Windows\Temp\FlexxAgentInstallation.log
Pastas
C:\Program Files\FlexxibleC:\ProgramData\Flexxible
Reinstalação
Para reinstalar o FlexxAgent em um dispositivo removendo sua configuração prévia, deve-se executar:
FlexxAgent-Installer.exe -repairAgent
Por exemplo:
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "-repairAgent true" -WindowStyle Hidden -Wait
Proteção contra a desinstalação
Esta funcionalidade impede que um usuário desinstale o FlexxAgent. A configuração pode ser aplicada a nível de Produto ou Grupo de relatório.
Requisitos
- A configuração somente pode ser feita por um usuário com o papel de Administrador de organização.
- Versão mínima do FlexxAgent: 25.4.2.
Esta funcionalidade está desativada por padrão.
Configuração a nível de Produto
- Acessar
Portal->Configuração->Organização. - No menu, selecionar a aba
Produtos. - Na tabela, escolher o ambiente sobre o qual se deseja executar a funcionalidade, e no campo
Açãoclicar emConfiguração do agente. - No formulário, habilitar ou desabilitar o botão
Proteção de desinstalação. - Clicar em
Salvar.
Configuração a nível de Grupos de relatório
A execução da funcionalidade pode ser feita sobre um ou vários grupos de relatório.
Habilitar a proteção a um grupo de relatório
- Acessar
Portal->Configuração->Grupos de relatório. - Na tabela, escolher o grupo de relatório sobre o qual se deseja executar a funcionalidade, e no campo
Açãoclicar emConfiguração do agente. - No formulário, edite a funcionalidade
Proteção de desinstalação(botão em forma de lápis) para poder escolher entre habilitá-la ou desabilitá-la. - Clicar em
Salvar.
Os grupos de relatório herdam a configuração feita a nível de Produto; no entanto, podem sobrescrever sua própria configuração.

Habilitar a proteção a vários grupos de relatório
- Acessar
Portal->Configuração->Grupos de relatório. - Na tabela, selecionar os grupos de relatório sobre os quais se deseja executar a funcionalidade.
- Clicar em
Editar proteção de desinstalação. Serão apresentadas três opções:
- Habilitar proteção de desinstalação. Protege os grupos de relatório contra a desinstalação do FlexxAgent (esta opção não estará disponível se a funcionalidade já estiver habilitada no Produto).
- Desabilitar proteção de desinstalação. Permite aos usuários desinstalar o FlexxAgent (esta opção não estará disponível se a funcionalidade já estiver desabilitada no Produto).
- Restabelecer proteção de desinstalação. Aplica a configuração que o Produto ao qual o grupo de relatório pertence, seja habilitada ou desabilitada.

Um dispositivo terá a Proteção contra a desinstalação do FlexxAgent habilitada nos seguintes casos:
- A funcionalidade está habilitada no grupo de relatório ao qual pertence.
- A funcionalidade está desativada no grupo de relatório (não está habilitada nem desabilitada), mas está habilitada a nível Produto.
Formas de desinstalar o FlexxAgent com a proteção habilitada
Se um usuário tiver a funcionalidade habilitada, mas precisar desinstalar o FlexxAgent, terá duas opções:
- Mover o dispositivo para um grupo de relatório que não tenha a proteção habilitada.
- Através de um token:
- Ir para
Portal->Workspacese selecionar o dispositivo. - Execute a ação
Reveal uninstall tokenque mostrará um token único para esse dispositivo, válido até as 23:59:59 UTC do dia seguinte. - Vá para o Painel de Controle do Windows e desinstale o FlexxAgent inserindo o token.

Antes de gerenciar a desinstalação do FlexxAgent através de ferramentas como Intune ou scripts próprios, os dispositivos desejados devem ser movidos para um grupo de relatório que não tenha proteção habilitada.
A Flexxible recomenda ter um grupo de relatório com a Proteção contra desinstalação desabilitada para facilitar tarefas de desinstalação do FlexxAgent nos dispositivos.
Problemas conhecidos
Instalação do FlexxAgent
Problema 1 - Instrumentação de Gerenciamento do Windows (WMI)
Se o dispositivo tiver problemas gerados pelo serviço Windows Management Instrumentation (WMI) durante a instalação ou reinstalação, é possível que o processo relate esses erros na janela do CMD:

Solução
Executar os seguintes comandos:
Stop-Service winmgmt -Force
winmgmt /resetrepository
Start-Service winmgmt
Problema 2 - Restrição de processos PowerShell
Algumas soluções de segurança não permitem que a instalação e/ou autoatualização do FlexxAgent seja realizada de forma eficaz. O instalador pode devolver a mensagem:
O processo foi terminado com erros. Uma instalação corrompida foi detectada devido a processos externos. Isso geralmente é causado pela atividade do antivírus. Por favor, verifique as configurações do seu antivírus.
Solução
Excluir os seguintes arquivos:
C:\Windows\Temp\FlexxibleIT
C:\Windows\Temp\UpdateFlexxAgent.ps1
Desinstalação do FlexxAgent
Problema - FlexxAgent continua na lista de serviços
Pode acontecer que o FlexxAgent continue aparecendo na lista de serviços, mesmo que tenha sido desinstalado e todos os arquivos tenham sido apagados. Isso provocaria a impossibilidade de reinstalação.
Solução
Executar como administrador o seguinte comando na janela de CMD:
sc delete "FlexxAgent service"
Em seguida, reiniciar o dispositivo.
Parâmetros compatíveis
| Parâmetro | Cara | Descrição | |
|---|---|---|---|
| proxyAbsoluteUri | [string] | URL e porta do proxy. | |
| proxyUser | [string] | Usuário para proxy autenticado. | |
| proxyPass | [string] | Senha para proxy autenticado. | |
| proxyPersistConfig | [switch] | Se especificado, a configuração é mantida no registro. | |
| configFilePath | [string] | Diretório alternativo para o arquivo FlexxAgent-Configuration.conf. | |
| DebugMode | [switch] | Quando especificado, ele cria um arquivo de texto na mesma pasta com a transcrição da execução do script. | |
| RepairAgent | [bool] | Remove a configuração pré-existente do FlexxAgent quando reinstalado em um dispositivo. | |
| Help | [switch] | Lista os parâmetros suportados, com tipo e descrição. |
Configuração de proxy
FlexxAgent suporta proxies configurados de forma transparente a nível do sistema, com ou sem autenticação. A configuração do proxy pode ser realizada por linha de comando ou mediante a modificação de chaves de registro.
Configuração de proxy mediante linha de comando
Instalação com parâmetros:
FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyPersistConfig:$True
Onde ip.ad.dre.ss:port corresponde ao IP ou DNS e a porta do proxy.
Ou incluindo credenciais:
FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyUser ProxyUserName -proxyPass ProxyUserPassword -proxyPersistConfig:$True
Pode ser que o FlexxAgent não tenha acesso ao proxy configurado se estiver fora da rede corporativa. Para determinar a acessibilidade, o FlexxAgent tenta resolver o registro DNS e faz uma solicitação TCP para a porta correspondente. Se o proxy não for acessível, o FlexxAgent reportará diretamente (sem proxy).
Configuração de proxy mediante chaves de registro
As chaves de registro que armazenam a configuração do proxy estão em:
'Equipe\HKEY_LOCAL_MACHINE\SOFTWARE\Políticas\Flexxible\FlexxAgent\Comunicações'
Chaves do Registro relacionadas às configurações de proxy:
Principais Proxy_URL
- Caminho:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Nome: Chave Proxy_URL
- Tipo: REG_SZ
- Valores suportados: a URL e a porta; por exemplo, 'http://192.168.1.1:3128' ou 'https://192.168.1.1:3128'
Proxy_User chave
- Caminho:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Nome: Chave Proxy_User
- Tipo: REG_SZ
- Valores suportados: o nome de usuário para autenticar no proxy; por exemplo, 'Administrador'. Ele pode ser ignorado para proxies não autenticados.
Principais Proxy_Pwd
- Caminho:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Nome: Chave Proxy_Pwd
- Tipo: REG_SZ
- Valores suportados: A senha para autenticar no proxy. Ele pode ser ignorado para proxies não autenticados.
O valor da chave Proxy_Pwd pode ser definido como texto sem formatação (não recomendado) ou codificado em base64 e delimitado por "&&&".
Por exemplo: '&&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&&' para o valor "Proxy_Pwd".
Em qualquer dos casos, o FlexxAgent cifra o valor assim que é iniciado ou tenta transmitir informações. Você pode gerar uma cadeia codificada em Base64 a partir de https://www.base64encode.org/.
Como o FlexxAgent desencadeia um processo a nível do sistema (FlexxAgent.exe) e outro a nível de sessão (FlexxAgent Analyzer.exe), pode ser necessário definir tipos de proxy diferentes para cada um, dependendo de como o proxy atua em um nível ou outro.
Isso pode ser feito nas Configurações do FlexxAgent, em Produtos.
Atualização manual
Para atualizar o FlexxAgent manualmente:
- Acesse
Workspaces->Nível 1->Workspaces->Operações->FlexxAgent->Atualizar FlexxAgent.

-
As versões instaladas podem ser consultadas em
Meus filtros->Filtros predefinidos->Resumo de versões do FlexxAgent. Isso mostrará uma visão de todos os dispositivos agrupados por versão. -
Uma vez executada a operação de atualização, será gerado um trabalho com todos os detalhes da operação.