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.
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)
- 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.
- 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.
- 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. - Restaure owner/ACL corretos da pasta WindowsApps. O proprietário padrão é
NT SERVICE\TrustedInstaller
. Corrupções de ACL nessa pasta ou na subpastaMSTeams_*
quebram a ativação do MSIX. - 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). - 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 emC:\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
- Atualize para FSLogix 2210 HF4+ e reinicie o host.
- Aplique exclusões no A/V/EDR para os executáveis listados (incluindo hook exclusions se suportado).
- Execute
fltmc
e remova drivers de filtro desnecessários (ex.: Citrix UPM) se não forem usados. - Repare ACL/owner de
C:\Program Files\WindowsApps
e, se possível, apenas da pastaMSTeams_*
; owner =TrustedInstaller
. - Ajuste FSLogix: desative o redirecionamento do
INetCache
(para teste) e revise políticas de pastas temporárias. - 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)
Elemento | Exclusão sugerida | Motivo | Observações |
---|---|---|---|
Cliente Teams (MSIX) | …\WindowsApps\MSTeams_*\ms-teams.exe | Evitar hooks no processo principal | Base para o autostart |
Atualizador do Teams | …\WindowsApps\MSTeams_*\ms-teamsupdate.exe | Atualizações/registro do MSIX | Reduz interferência em updates |
Autostarter do Teams | …\WindowsApps\MSTeams*\msteams_autostarter.exe | Processo que falha no logon | Inclua em hook exclusions |
Serviço FSLogix | …\FSLogix\Apps\frxsvc.exe | Evitar atrasos no profile attach | Evite 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
emsteams_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 comoUPMAction
eupmjit
(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.
- Faça backup de ACLs (opcional).
- Execute, elevado:
icacls "C:\Program Files\WindowsApps" /reset /t /c /q
- Reaplique o owner:
icacls "C:\Program Files\WindowsApps" /setowner "NT SERVICE\TrustedInstaller" /t /c
- 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ística | Classic Teams | New Teams |
---|---|---|
Modelo de instalação | Per‑user, pasta do perfil | MSIX per‑machine em WindowsApps |
Localização dos binários | %LocalAppData% | C:\Program Files\WindowsApps\MSTeams_* |
Método de autostart | Run key/atalhos tradicionais | msteams_autostarter.exe e ativação MSIX |
Sensibilidade a ACL/EDR | Menor | Maior (depende do pipeline MSIX) |
Fluxo de diagnóstico sugerido
- Teste de base: logon em host sem A/V. Se funcionar, foque em EDR/A‑V.
- Execute
fltmc
: há UPM ou outros filtros? Remova o que não usa. - Confirme FSLogix 2210 HF4+ instalado e em execução.
- Verifique owner/ACL de
WindowsApps
e da pastaMSTeams_*
. - Aplique exclusões de A/V/EDR + hook exclusions para os 3 executáveis do Teams.
- Ajuste INetCache no FSLogix (não redirecionar) e reteste.
- 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 pastaWindowsApps
. - 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 (removerUPMAction
/upmjit
se não usar UPM)WindowsApps
com ownerTrustedInstaller
e ACLs íntegrasINetCache
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)
- Comunicar a janela de manutenção (se necessário) e tirar 1 host do broker para laboratório.
- Instalar/confirmar FSLogix 2210 HF4+; reiniciar.
- Aplicar exclusões A/V/EDR + hook exclusions para
ms-teams.exe
,ms-teamsupdate.exe
,msteams_autostarter.exe
. - Executar
fltmc
→ remover UPM ou outros drivers de perfil que você não usa. - Validar/ajustar owner/ACL de
WindowsApps
(owner:TrustedInstaller
). - Desativar temporariamente o redirecionamento de
INetCache
no FSLogix para o grupo piloto. - 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.