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 e sem interface gráfica, portanto, é perfeitamente compatível com mecanismos de implantação autônoma, bem como com o uso do assistente de instalação.

FlexxAgent é composto por um serviço do Windows chamado FlexxAgent Service, que dirige dois processos: FlexxAgent, que executa a nível de sistema, e FlexxAgent Analyzer, que inicia para cada sessão de usuário.
Essa estrutura permite que o FlexxAgent lide com dispositivos de várias sessões, como servidores de terminal, Citrix ou AVD, e adquira métricas detalhadas para melhorar os recursos de diagnóstico.
Por exemplo, se uma pessoa está trabalhando em seu laptop, o processo FlexxAgent executaria a nível de sistema e o FlexxAgent Analyzer a partir da identidade do usuário. Se o dispositivo hospedar múltiplas sessões de usuário, além de FlexxAgent a nível de sistema, FlexxAgent Analyzer executaria por cada sessão de usuário nesse dispositivo.
Consumos
Em termos de requisitos de recursos, o FlexxAgent tem consumos muito otimizados, em torno dos seguintes valores:
- Espaço em disco usado: < 200 MB
- CPU: < 0.5%
- RAM: 100-200 MB
Processo FlexxAgent (sistema)
- Para a informação de consumo de recursos, que inclui contadores de desempenho, hardware, sessões, perfis, discos, partições e serviços do Windows, o valor padrão é 60 segundos.
- Os eventos de erro do log de eventos são enviados a cada 10 minutos.
- As informações do perfil do usuário são recuperadas a cada 15 minutos.
Processo FlexxAgent Analyzer (usuário)
- Inclui análise do uso do aplicativo, dados de diagnóstico e experiência do usuário.
- Os dados são coletados localmente a cada 15 segundos.
- O relatório é enviado ao serviço a cada 5 minutos, embora essa métrica possa mudar em funcionalidades específicas.
Esses valores podem ser ajustados na seção Settings nas diferentes consoles, o que proporciona flexibilidade para se adequar às necessidades específicas.
Versões suportadas
Os sistemas operacionais suportados pelo FlexxAgent são aqueles que ainda estão no ciclo de suporte de seu fabricante. Embora a instalação seja permitida em versões que não possuem esse suporte, deve-se levar em consideração que certas funcionalidades podem não estar disponíveis.
Os sistemas operacionais da Microsoft com suporte e compatibilidade completos são:
- Microsoft Windows 10 ou posterior
- Microsoft Windows Server 2016 ou posterior
O FlexxAgent também pode ser instalado no Windows 7 e 8.1 SP1, Windows Server 2008 R2 SP1 e Windows Server 2012, mas estará sujeito a algumas limitações.
Requisitos de software
FlexxAgent requer certos componentes de software:
- .NET Framework 4.6.2 ou posterior, Flexxible recomenda instalar
.NET Framework 4.8. - Windows PowerShell 4.0 ou posterior (Windows PowerShell 5.1 recomendado)
- Nota: A política de execução do Azure PowerShell deve ser configurada como
Sem restrições.
- Nota: A política de execução do Azure PowerShell deve ser configurada como
Considerações para versões do Windows em EOL
As versões do Windows em End of Life (EOL), isto é, que estão fora de suporte, têm algumas limitações na execução do FlexxAgent, o que pode ocasionar que certas funcionalidades não sejam suportadas.
Limitações
Quando o FlexxAgent é utilizado em sistemas operacionais Windows antigos que estão fora de suporte, não são aceitas as seguintes características:
- Coletando métricas de consumo de GPU
- Execução de fluxos
- Execução de microsserviços pelo usuário final
- Informações das unidades de armazenamento
- No caso de dispositivos virtuais, a detecção de broker e hipervisor não está disponível para todos os provedores.
- Não há dados de User Input Delay (UID) porque este contador só é compatível com Windows Server 2019 em diante e com Windows 10, versão 1809, em diante.
A detecção de intermediários pode não funcionar para todos os intermediários. 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
A instalação do FlexxAgent suporta o sistema operacional Windows 7 x64 ou Windows Server 2008 R2 SP1, sob as seguintes condições:
- Deve ser instalada a atualização KB4474419:
SHA-2 code signing support update for Windows Server 2008 R2, Windows 7, and Windows Server 2008: September 23, 2019. - Deve ser instalada a atualização KB3140245:
Update to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windowse seguir as instruções da seçãoHow to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windowsda página de suporte da Microsoft. - Requer, pelo menos, .NET Framework 4.6, mas a Flexxible recomenda instalar
.NET Framework 4.8. - PowerShell 2.0 com Windows 7 não é compatível com a versão TLS 1.2 necessária para instalar FlexxAgent. É necessário instalar
Windows Management Framework 5.1, que instala PowerShell 5.1.
Windows 8 e 2012
A instalação do FlexxAgent suporta o sistema operacional Windows 8 sob as seguintes condições:
- É necessário
.NET Framework 4.6.2, a Microsoft bloqueia a instalação de versões posteriores do .NET Framework no Windows 8.0. - São necessárias todas as atualizações de segurança do Windows para garantir a
compatibilidade com TLS 1.2 e a assinatura de código SHA-2.
Descarga
DOWNLOAD DO BINÁRIO DE INSTALAÇÃO SEM INTERFACE GRÁFICA
O download do FlexxAgent sem interface gráfica é feito a partir de Workspaces -> Nível 2 -> Grupos de reporte.
Na tabela da vista de lista deve-se selecionar o grupo de relatório sobre o qual deseja baixar o agente e clicar no botão Baixar FlexxAgent.

Uma janela será aberta para baixar o instalador do FlexxAgent.

-
Se a opção
Generate standalone installer (offline)for selecionada, durante a instalação, o binário não exigirá acesso à internet para verificação ou download dos binários. -
Se, por outro lado, não for selecionada a opção
Generate standalone installer (offline), o pacote de instalação mínimo será baixado. Dessa forma, o binário acessará a internet para verificar e baixar os binários mais recentes.
Implantação autônoma
FlexxAgent suporta ser lançado por meio de métodos de implantação desatendidos, tais como distribuição por GPOs, Intune, SSCM e muitas outras ferramentas.
Instalação
A instalação do FlexxAgent de forma desatendida é realizada através do PowerShell.
Processo inicial'<ruta>\FlexxAgent-Installer.exe" -ArgumentList "<agregar parámetro>" -WindowStyle oculto -Esperar
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 de Windows da Microsoft utilizado para desinstalar o FlexxAgent não remove todos os arquivos, pastas, chaves de registro ou valores de registro criados durante a instalação do FlexxAgent. Se precisar de uma imagem limpa do sistema, pode remover com segurança os seguintes arquivos, pastas, chaves de registro e valores de registro.
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é-existente deve-se executar:
FlexxAgent-Installer.exe -repairAgent
Por exemplo:
Processo inicial'<ruta>\FlexxAgent-Installer.exe" -ArgumentList "-repairAgent true" -WindowStyle Hidden -Wait
Proteção contra a desinstalação
Essa funcionalidade permite proteger o processo de desinstalação do FlexxAgent para evitar que um usuário possa desinstalá-lo dos dispositivos. A configuração pode ser realizada a nível de Produto e Grupos de relatório.
Considerações
- A configuração só pode ser realizada por um usuário Administrador de organização.
- É necessário ter instalada a versão 25.4.2 do FlexxAgent.
- Por padrão, a funcionalidade está desabilitada.
Configuração a nível 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 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 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 tem para o grupo de relatório, 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 a 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)
Durante a instalação e/ou reinstalação do FlexxAgent, se o computador tiver problemas gerados pelo serviço Instrumentação de Gerenciamento do Windows (WMI), é possível que o processo relate esses erros na janela de 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 do dispositivo:
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 que o FlexxAgent não possa ser reinstalado.
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ções de proxy
FlexxAgent suporta proxies configurados de forma transparente a nível de sistema. Proxies com e sem autenticação também são suportados. A configuração do proxy pode ser feita por linha de comando ou modificando as chaves do Registro que controlam essa configuração.
Configuração de proxy via 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 é para o IP ou DNS mais a porta 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, ele reportará diretamente (sem proxy).