Novo Teams no Windows Server (RDS + FSLogix): corrigir o erro “The parameter is incorrect” no auto‑início

O New Teams pode falhar ao auto‑iniciar em RDS com FSLogix exibindo “The parameter is incorrect”. Este guia prático consolida causas reais e correções validadas em campo, com passos reproduzíveis, comandos e checklist para você restaurar o autostart com segurança.

Índice

Sintomas e contexto

Em hosts Windows Server 2022 (ou 2019) usados como RDS/Remote Desktop Services e com perfis FSLogix, após o sign‑in do usuário o New Teams instalado via bootstrapper tenta iniciar automaticamente e falha com a mensagem:

“Something went wrong… The parameter is incorrect”

Em alguns ambientes, o evento é acompanhado por falha do processo msteams_autostarter.exe. No Classic Teams (legado), o erro não se manifesta.

Resumo da causa (em linguagem direta)

Na imensa maioria dos casos, o problema nasce da combinação: pacote MSIX do New Teams + drivers/filtros de A/V ou EDR + perfis redirecionados pelo FSLogix. Interferências de hook em tempo de execução, ACLs incorretas em C:\Program Files\WindowsApps (onde o MSIX do Teams reside) e configurações específicas de cache/temporários do FSLogix criam falhas intermitentes justamente no autostarter.

Correções consolidadas (do mais eficaz ao menos comum)

  1. Atualize o FSLogix para 2210 Hotfix 4 (HF4) ou superior. HF4 incorpora correções específicas para o New Teams em Windows Server 2019/2022, contemplando os erros “The parameter is incorrect” e “Invalid function”. Em muitos ambientes, somente a atualização já normalizou o autostart.
  2. Trate interferência de Antivírus/EDR (exclusões e “hook exclusions”). Aplique exclusões para os binários do Teams (MSIX) e, em último caso, do FSLogix. Alguns fabricantes (como SentinelOne, Cortex, Trend Micro Apex One, Symantec, Bitdefender) foram citados como sensíveis; onde suportado, inclua hook exclusions.
  3. Remova/neutralize drivers de filtro conflitantes. Verifique com fltmc e elimine drivers de perfil que você não usa (ex.: Citrix UPM – UPMAction, upmjit), pois eles podem disputar o perfil com o FSLogix.
  4. Restaure owner/ACL corretos da pasta WindowsApps. O proprietário padrão é NT SERVICE\TrustedInstaller. Corrupções de ACL nessa pasta ou na subpasta MSTeams_* quebram a ativação do MSIX.
  5. Ajuste políticas do FSLogix para cache temporário. Alguns admins eliminaram intermitências (falha a cada 2º logon) ao não redirecionar o INetCache via política de pastas temporárias ou regra de exclusão. Em ODFC, valide o registro on‑demand do Teams no sign‑in (HF4 também ajuda aqui).
  6. Valide o ambiente e faça “sanity checks”. Teste a imagem sem A/V para isolar o culpado; confirme uso do bootstrapper correto; verifique diferenças de políticas/GPO e de tenants (sim, já houve ambiente onde dois tenants funcionavam e um não).

Por que isso acontece no New Teams (MSIX) + FSLogix + RDS

  • MSIX per‑machine em WindowsApps: o New Teams é empacotado como MSIX e fica em C:\Program Files\WindowsApps\MSTeams_*. O autostarter chama componentes do pacote e precisa de ACLs/owner intactos.
  • FSLogix Profile/ODFC Container: redireciona AppData e perfis para VHD/VHDX. Pastas temporárias e caches (como INetCache) podem amplificar condições de corrida, especialmente em logons simultâneos.
  • EDR/A‑V com hooks: mecanismos de inspeção (user‑mode/kernel) adicionam camadas de filtro a processos e a I/O do MSIX. Em certas versões/configurações, isso impede a inicialização do msteams_autostarter.exe e amigos.

Solução rápida: sequência recomendada

  1. Atualize para FSLogix 2210 HF4+ e reinicie o host.
  2. Aplique exclusões no A/V/EDR para os executáveis listados (incluindo hook exclusions se suportado).
  3. Execute fltmc e remova drivers de filtro desnecessários (ex.: Citrix UPM) se não forem usados.
  4. Repare ACL/owner de C:\Program Files\WindowsApps e, se possível, apenas da pasta MSTeams_*; owner = TrustedInstaller.
  5. Ajuste FSLogix: desative o redirecionamento do INetCache (para teste) e revise políticas de pastas temporárias.
  6. Reteste com perfil de usuário novo (limpo) e, se possível, compare com um host golden image sem A/V.

Comandos prontos para copiar

Listar filtros de sistema de arquivos e drivers de perfil

fltmc

Procure por entradas como UPMAction e upmjit (Citrix UPM). Se não usar UPM, remova o produto (por exemplo, o profilemgt_x64.msi) para eliminar os drivers.

Reparar ACLs e owner da pasta WindowsApps

Atenção: altere o mínimo possível; prefira atuar só na subpasta do MSTeams_* se o problema for localizado.

icacls "C:\Program Files\WindowsApps" /reset /t /c /q
icacls "C:\Program Files\WindowsApps" /setowner "NT SERVICE\TrustedInstaller" /t /c

Exclusões de A/V e EDR (exemplos)

C:\Program Files\WindowsApps\MSTeams_*\ms-teams.exe
C:\Program Files\WindowsApps\MSTeams_*\ms-teamsupdate.exe
C:\Program Files\WindowsApps\MSTeams*\msteams_autostarter.exe
C:\Program Files\FSLogix\Apps\frxsvc.exe   (evite se possível; use somente se necessário)

Checar versão do FSLogix e owner da WindowsApps (PowerShell)

$frx = Get-Item 'C:\Program Files\FSLogix\Apps\frxsvc.exe' -ErrorAction SilentlyContinue
$frx?.VersionInfo | Select-Object FileVersion,ProductVersion

(Get-Acl 'C:\Program Files\WindowsApps').Owner 

Tabela de exclusões recomendadas (A/V e EDR)

ElementoExclusão sugeridaMotivoObservações
Cliente Teams (MSIX)…\WindowsApps\MSTeams_*\ms-teams.exeEvitar hooks no processo principalBase para o autostart
Atualizador do Teams…\WindowsApps\MSTeams_*\ms-teamsupdate.exeAtualizações/registro do MSIXReduz interferência em updates
Autostarter do Teams…\WindowsApps\MSTeams*\msteams_autostarter.exeProcesso que falha no logonInclua em hook exclusions
Serviço FSLogix…\FSLogix\Apps\frxsvc.exeEvitar atrasos no profile attachEvite se possível; “força bruta”

Passo a passo detalhado

Atualize o FSLogix para 2210 HF4 ou superior

Instale o HF4 (ou versão mais recente) em todos os hosts, reinicie e repita o teste de logon. Muitos ambientes reportaram que apenas essa ação estabilizou o autostart do New Teams, inclusive em cenários com A/V agressivo. Se a melhora for parcial (falha intermitente), continue para os próximos passos.

Exclusões no A/V/EDR e “hook exclusions”

  • Crie exclusões de caminho para os binários do Teams e, se necessário, do FSLogix.
  • Se seu produto suportar hook exclusions (p. ex., SentinelOne), crie regras específicas para ms-teams.exe, ms-teamsupdate.exe e msteams_autostarter.exe.
  • Valide em laboratório: uma imagem sem A/V deve iniciar o Teams sem erro — se funcionar, você confirmou o fator bloqueante.

Remoção de drivers de filtro conflitantes

  • Rode fltmc e revise a lista. Se encontrar drivers de perfil como UPMAction e upmjit (Citrix UPM) e você não usa UPM, desinstale-o.
  • Drivers adicionais de perfil/UPM que competem com FSLogix tendem a causar o erro no autostart do Teams em sessões RDS concorrentes.

Reparar owner/ACL de WindowsApps

O pacote MSIX do Teams depende de permissões consistentes em C:\Program Files\WindowsApps. ACLs incorretas ou alteração de owner podem impedir o activation manager de inicializar o autostarter.

  1. Faça backup de ACLs (opcional).
  2. Execute, elevado: icacls "C:\Program Files\WindowsApps" /reset /t /c /q
  3. Reaplique o owner: icacls "C:\Program Files\WindowsApps" /setowner "NT SERVICE\TrustedInstaller" /t /c
  4. Reinicie o host e teste. Se o problema for localizado ao Teams, atue apenas em …\WindowsApps\MSTeams_*.

Ajustes de cache/temporários do FSLogix

Administradores relataram que a falha a cada segundo logon sumiu ao não redirecionar o INetCache no container de perfil (via política de pastas temporárias / regra de exclusão). Em ambientes ODFC, confirme que o Teams está realizando o on‑demand registration no sign‑in (HF4 também aborda este ponto).

Dica: faça o ajuste inicialmente apenas para um grupo piloto e monitore impacto em I/O e experiência do usuário antes de consolidar em produção.

Validações e “sanity checks”

  • Imagem sem A/V: se o New Teams inicia normalmente, o gargalo é o EDR/A‑V.
  • Bootstrapper correto: certifique-se de ter usado o instalador oficial per‑machine do New Teams.
  • Políticas/GPO/tenant: verifique se não há GPOs divergentes entre grupos/tenants. Já houve casos em que 2 tenants funcionavam e 1 não.

Comparativo rápido: Classic vs New Teams (por que só um falha)

CaracterísticaClassic TeamsNew Teams
Modelo de instalaçãoPer‑user, pasta do perfilMSIX per‑machine em WindowsApps
Localização dos binários%LocalAppData%C:\Program Files\WindowsApps\MSTeams_*
Método de autostartRun key/atalhos tradicionaismsteams_autostarter.exe e ativação MSIX
Sensibilidade a ACL/EDRMenorMaior (depende do pipeline MSIX)

Fluxo de diagnóstico sugerido

  1. Teste de base: logon em host sem A/V. Se funcionar, foque em EDR/A‑V.
  2. Execute fltmc: há UPM ou outros filtros? Remova o que não usa.
  3. Confirme FSLogix 2210 HF4+ instalado e em execução.
  4. Verifique owner/ACL de WindowsApps e da pasta MSTeams_*.
  5. Aplique exclusões de A/V/EDR + hook exclusions para os 3 executáveis do Teams.
  6. Ajuste INetCache no FSLogix (não redirecionar) e reteste.
  7. Valide com perfil novo para descartar resquícios no usuário antigo.

Observações práticas do campo

  • Em vários ambientes, HF4 por si só resolveu completamente (ex.: com Symantec). Em outros, a correção final veio após as exclusões de A/V ou a reparação de ACL.
  • Excluir frxsvc.exe do A/V/EDR ajuda, mas é medida extrema. Prefira focar nos binários do Teams e na pasta WindowsApps.
  • Se você instalou Citrix UPM apenas para métricas de logon, considere removê-lo: há casos em que o problema sumiu assim.

Checklist final

  • FSLogix 2210 HF4+ instalado
  • Exclusões de A/V/EDR (incl. msteams_autostarter.exe) aplicadas
  • fltmc sem drivers conflitantes (remover UPMAction/upmjit se não usar UPM)
  • WindowsApps com owner TrustedInstaller e ACLs íntegras
  • INetCache não redirecionado (teste) e políticas FSLogix revisadas
  • Reteste com perfil novo e compare com host sem A/V

Boas práticas para evitar recorrência

  • Padronize imagens de RDS: mesma versão de FSLogix e do New Teams entre hosts, reduzindo variações de comportamento.
  • Audite ACLs críticas: monitore alterações em WindowsApps e subpastas do Teams.
  • Documente exclusões A/V em código (IAC/DevOps) para reaplicar automaticamente em novos servidores.
  • Separe Profile e ODFC quando possível: dá clareza ao troubleshooting e reduz contaminação cruzada.
  • Valide atualizações do EDR em laboratório antes de promover a produção; pequenos patches de hooking podem reintroduzir o erro.

FAQ — dúvidas comuns

Atualizar o FSLogix basta?

Muitas vezes, sim. Porém, se seu EDR/A‑V aplica hooks agressivos, você ainda precisará de exclusões. ACLs quebradas em WindowsApps também pedem correção.

Preciso excluir o frxsvc.exe do A/V?

Apenas se necessário. Comece pelos binários do Teams e pela pasta WindowsApps. Excluir o serviço do FSLogix é “força bruta”.

Por que o Classic Teams não tem esse problema?

Porque usa outro modelo (per‑user) e depende menos da ativação MSIX e das ACLs de WindowsApps.

Como saber se o problema é realmente o EDR?

Faça o teste em um host idêntico sem EDR/A‑V. Se o New Teams iniciar, você isolou a causa.

Registros e logs úteis

  • FSLogix: C:\ProgramData\FSLogix\Logs\Profiles\*.
  • Eventos de MSIX: Visualizador de Eventos → AppXDeployment‑Server (erros de ativação/registro do pacote).
  • Teams: ao ocorrer a falha, anote horário e correlacione com eventos do sistema e do EDR.

Exemplo de playbook (para colar no runbook da equipe)

  1. Comunicar a janela de manutenção (se necessário) e tirar 1 host do broker para laboratório.
  2. Instalar/confirmar FSLogix 2210 HF4+; reiniciar.
  3. Aplicar exclusões A/V/EDR + hook exclusions para ms-teams.exe, ms-teamsupdate.exe, msteams_autostarter.exe.
  4. Executar fltmc → remover UPM ou outros drivers de perfil que você não usa.
  5. Validar/ajustar owner/ACL de WindowsApps (owner: TrustedInstaller).
  6. Desativar temporariamente o redirecionamento de INetCache no FSLogix para o grupo piloto.
  7. Testar com perfil novo. Se OK, promover as mudanças aos demais hosts.

Conclusão

O erro “The parameter is incorrect” no New Teams em RDS + FSLogix raramente é um “bug isolado” do cliente. Na prática, ele sinaliza conflitos entre MSIX, drivers de filtro (A/V/EDR) e redirecionamento de perfil. Seguindo a sequência recomendada — FSLogix 2210 HF4+, exclusões de A/V/EDR, remoção de filtros desnecessários e reparo de ACL/owner em WindowsApps, além do ajuste de INetCache — a maioria absoluta dos ambientes volta a iniciar o Teams de forma estável e previsível.

Índice