Solucionando problemas da nova otimização

Ao solucionar problemas da nova otimização baseada em Slimcore para o Microsoft Teams, você precisa saber se os usuários estão otimizados com a pilha WebRTC herdada ou com a nova pilha. Eles também podem acabar no modo de fallback "SlimCore Media Not Connected" (ou renderização do lado do servidor).

  • Não otimizado com SlimCore e, em vez disso, você vê:
    "Mídia da Área de Trabalho Virtual do Azure otimizada"
    "Citrix HDX otimizado"

    • Os códigos de erro 2000 ("Sem Plug-in") e 2003 ("Canal Virtual não permitido") são as causas mais prováveis.
    1. Certifique-se de que sua política "Lista de permissões de canal virtual" no Citrix Studio esteja configurada corretamente para permitir MSTEAMS, MSTEAM1 MSTEAM2.
    2. Verifique se o ponto de extremidade tem o plug-in e se o Cliente VDI com o Process Explorer o carrega:
      1. Execute o explorador de processos.
      2. Habilite o painel inferior e alterne para a guia DLL.
      3. Em Área de Trabalho Virtual do Azure, procure o processo msrdc.exe e verifique se o MsTeamsPluginAvd.dll está carregado.
      4. No Citrix, procure o processo wfica32.exe e verifique se o MsTeamsPluginCitrix.dll está carregado.
    3. Reinicie o aplicativo Teams. É necessário um reinicialização para fazer a transição do WebRTC para o SlimCore, quando o plug-in é detectado pela primeira vez.
    4. Se o problema persistir, marcar Visualizador de Eventos na máquina virtual (VM) para erros relacionados à VDI do Microsoft Teams (Teams 24123.X.X.X ou superior).
  • Não otimizado com o SlimCore e, em vez disso, você vê: "A mídia do SlimCore da Área de Trabalho Virtual do Azure não está conectada" ou "A mídia do Citrix SlimCore não está conectada".

Dashboard de Integridade do Cliente do Teams

A integridade do cliente do Teams no Centro de Administração do Teams é uma página totalmente nova com um conjunto de dados, insights e ferramentas para ajudar os administradores a solucionar e resolver problemas de VDI. Na guia "Problemas", os administradores podem encontrar erros de "falha de otimização de VDI", com descrições e ações de correção para gerenciar e corrigir problemas antes que eles afetem a produtividade do usuário final ou causem novos escalonamentos. Esses erros normalmente são acionáveis - por meio de GPOs, definições de rede, configurações ou AppX. Eles são causados por atividades relacionadas ao MSIX quando o plug-in tenta instalar/carregar/implantar o SlimCore ou configurações ausentes, como a lista de permissões do Citrix Virtual Channel ou um plug-in ausente. Os códigos de erro são mapeados na tabela abaixo.

Dica

As informações expostas no TCH são inestimáveis para o administrador - tanto como uma ferramenta de monitoramento proativa quanto reativa. A Microsoft recomenda revisar as informações diariamente/semanalmente e criar os relatórios automatizados correspondentes.

Captura de tela que mostra a página de integridade do cliente do Teams.

Logs do Teams para VDI

Os logs do Teams podem ser coletados selecionando Ctrl+Alt+Shift+1 durante a execução do Teams em uma VM. Essa ação produz uma pasta ZIP na pasta Downloads. Dentro do arquivo PROD-WebLogs-*.zip, procure a pasta Core.

Área de Trabalho Virtual do Azure/W365 Citrix
"vdiConnectedState": {"connectedStack": "remote"}, "vdiVersionInfo": {"bridgeVersion": "2024.18.1.11", "remoteSlimcoreVersion": "2024.18.01.11", "nodeId": "1051a908af6b160e", "clientOsVersion": "10.0.22631", "rdClientVersion": "1.2.5405.0", "rdClientProductName": "Microsoft® Área de Trabalho Remota", "pluginVersion": "2024.14.01.1", "screenShareFallback": true} "vdiConnectedState": {"connectedStack": "remoto"}, "vdiVersionInfo": {"bridgeVersion": "2024.18.1.14", "remoteSlimcoreVersion": "2024.18.01.14", "nodeId": "ffffffff93eaee6a", "clientOsVersion": "10.0.22631", "rdClientVersion": "24.3.0.64", "rdClientProductName": "Citrix Workspace", "pluginVersion": "2024.15.01.3", "screenShareFallback": true}
  • vdiConnectedState mostra a pilha de chamadas ativa atual.
    • connectedStack: remote indica que o Teams foi conectado com sucesso ao ponto de extremidade remoto por meio do canal virtual. Isso não significa necessariamente que a pilha de chamadas foi inicializada com êxito, portanto, o usuário ainda pode encontrar falhas relacionadas à chamada, como não conseguir iniciar uma chamada.
    • connectedStack: local indica que a conexão do canal virtual falhou. O usuário agora está no modo de fallback.
  • vdiVersionInfo fornece informações úteis para o cliente e o ponto de extremidade do Teams.
    • bridgeVersion está vinculado à versão do cliente de área de trabalho do Teams em execução na VM.
    • remoteSlimcoreVersion é a versão da VDI do SlimCore que está disponível no ponto de extremidade.
    • nodeId é uma ID exclusiva vinculada ao ponto de extremidade.
    • clientOsVersion é a versão do sistema operacional para o ponto de extremidade.
    • rdClientVersion é a versão do cliente de área de trabalho remota em execução no ponto de extremidade, que é usado para se conectar à VM.
    • rdClientProductName é o nome do cliente de área de trabalho remota em execução no ponto de extremidade.
    • pluginVersion é a versão do plug-in integrada ao cliente da área de trabalho remota.

Diagnostics-logs.txt

Esse arquivo também pode ser encontrado em Weblogs\user(..). Para investigar ainda mais os problemas relacionados à conexão VDI, usando a palavra-chave vdiBridgeEventsHandler fornece os logs dos manipuladores de eventos de conexão e desconexão do vdiBridge, conforme mostrado (tratamento de eventos onConnected) no exemplo a seguir de uma conexão bem-sucedida com a nova pilha de otimização:

7432 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: end, currentStack=remote 7435 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - new calling stack type set: currentStack=remote 7436 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - deviceManagerService reloaded 7445 2024-03-01T17:51:22.031Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - calling stack reinit complete with nextStack=remote 7464 2024-03-01T17:51:21.785Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - starting calling stack reinit with nextStack=remote 7465 2024-03-01T17:51:21.785Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - SlimCore replacement complete, remote is now available 7467 2024-03-01T17:51:21.783Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - setVDIOptimizationModeOverride: from SlimCore to SlimCore 7468 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: isVersionMismatch=false, forceVersion=undefined, bridgeVersion=2024.5.1.11 7469 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - cached local SlimCore for future (fallback), currentStack=local 7470 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: start, vendorType=1, remoteSlimcoreVersion=2024.05.01.11, platform=win-x86, loadErrc=1, deployErrc=24002, nodeId=ffffffffbd7d5e77 7471 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - enqueueBridgeCallback: adding onConnected to queue, 0 bridge callbacks in queue, isBridgeCallbacksQueueProcessing=false

Erro de conexão

Se houver um erro de conexão, o código de erro poderá ser encontrado na linha de log que contém "loadErrc" e "deployErrc". Um erro de implantação (também conhecido como install_error) é um erro que ocorre quando o plug-in estava tentando baixar o pacote SlimCore MSIX da Rede de Distribuição de Conteúdo da Microsoft. Em seguida, o plug-in tenta preparar ou provisionar o pacote para o ponto de extremidade usando o Serviço de Preparação de Aplicativos para AppX. Um erro de carregamento é um erro que ocorre quando o plug-in tenta iniciar MsTeamsVdi.exe e estabelecer uma RPC (Chamada de Procedimento Remoto) para ele.

O código registrado aqui precisa ser mapeado usando esta tabela:

Código de erro Standard loadErrc ou deployErrc Definição Observações
0 0 OK Não é um erro. Sucesso do 'SlimCore Connected', o usuário está devidamente otimizado
5 43 ERROR_ACCESS_DENIED MsTeamsVdi.exe processo falhou na inicialização. A ativação de BlockNonAdminUserInstall pode causar esse erro. Ou o ponto de extremidade pode estar ocupado registrando vários pacotes MSIX depois que um logon do usuário e o serviço AppX não concluir o registro do SlimCoreVdi.
110 ERROR_OPEN_FAILED Políticas de acesso em segundo plano do Windows bloqueando o BITS ('BG_E_BLOCKED_BY_BACKGROUND_ACCESS_POLICY'), o que impede downloads do SlimCore durante a otimização. Para usuários do AVD/W365, o aplicativo do aplicativo do Windows pode não ter a permissão do aplicativo em segundo plano -> 'Permitir que este aplicativo seja executado em segundo plano' definida como 'Sempre' em Configurações do Windows/Aplicativos/Aplicativos instalados/Aplicativo do aplicativo do Windows. Se essa opção não estiver visível, marque se GlobalUserDisabled está definido como 1 e altere-o para 0, em HKCU\Software\Microsoft\Windows\CurrentVersion\BackgroundAccessApplications
403 3227 HTTP_STATUS_FORBIDDEN Verifique com suas equipes de rede e proxy, pois algo está bloqueando os downloads do SlimCore MSIX. Status HTTP 403 - o servidor compreendeu a solicitação, mas recusou-se a atendê-la.
404 3235 HTTP_STATUS_NOT_FOUND Problema de publicação: o pacote SlimCore MSIX não foi encontrado na Rede de Distribuição de Conteúdo. Possível interferência de servidores proxy
1260 10083 ERROR_ACCESS_DISABLED_BY_POLICY Esse erro geralmente significa que o Gerenciador de Pacotes do Windows não pode instalar o pacote SlimCore MSIX. Visualizador de Eventos pode mostrar o código de erro hexadecimal 0x800704EC. As políticas do AppLocker podem causar esse código de erro. Você pode desabilitar o AppLocker ou adicionar uma exceção para pacotes SlimCoreVdi em Política de Segurança Local -> Políticas de Controle de Aplicativo -> AppLocker. Verifique a Etapa 3 em "Otimizando com a nova solução VDI para o Teams".
1460 11683 ERROR_time-out MsTeamsVdi.exe processo falhou na inicialização (tempo limite de 60 segundos). Os sintomas podem ser uma transição lenta para a otimização do SlimCore, uma possível "mídia do SlimCore não conectada" e uma eventual recuperação após aguardar ou reiniciar. Provavelmente causa raiz A implantação/registro do SlimCore MSIX foi concluída muito lentamente.
1722 13779 RPC_S_SERVER_UNAVAILABLE 'O servidor RPC (Chamada de Procedimento Remoto) não está disponível'. MsTeamsVdi.exe não conseguiu se comunicar com um componente de serviço do Windows do qual ele depende durante a inicialização do SlimCore, provavelmente o Serviço de Preparação de Aplicativos (ARS), APIs do Gerenciador de Pacotes ou APIs de Registro de Pacotes. Se esses componentes estiverem indisponíveis, travados ou reiniciando, serão esperados erros de RPC. Um cenário comum são os thin clients lentos que estão sobrecarregados nos logons do usuário ou os registros do AppX estão atrasados. O registro SlimCore corrompido ou incompleto também pode ser a causa. Se a otimização for bem-sucedida, trate 1722 como uma condição transitória em vez de uma falha de inicialização de MsTeamsVdi.exe difícil. Informações de log adicionais podem ser obtidas no Visualizador de Eventos do ponto de extremidade (AppXDeployment-Server/Operational e AppxPackagingOM/Operational)
2000 16002 Nenhum plug-in O ponto de extremidade não tem o MsTeamsPlugin ou, se tiver, não carregou (marcar com o Process Explorer).
2001 16008 Canal Virtual Não Disponível Erro no Citrix VDA (agente de entrega virtual) WFAPI ou Omnissa Agent Blast API
2003 16026 Os Canais Virtuais Personalizados (MSTEAMS, MSTEAM1 e MSTEAM2) estão bloqueados devido a uma política do Citrix Studio Revise a seção da lista de permissões do canal virtual Citrix do artigo VDI 2.0.
2004 16032 Versão do Citrix Workspace App não suportada. Atualize
2005 16043 O Teams está sendo executado como um Aplicativo Publicado (Citrix) ou RemoteApp (AVD/Windows 365) O usuário não atende aos requisitos mínimos de versão - o Teams não carrega o SlimCore neste caso e os usuários são sempre otimizados com WebRTC.
2008 16066 O aplicativo do Windows para MAC no AVD/365 é da App Store, que não tem suporte. Há suporte apenas para aplicativos do Windows que não são da loja.
3000 24002 SlimCore Implantação não necessária Este código não é realmente um erro. É um bom indicador de que o usuário está na nova arquitetura de otimização com SlimCore.
3001 24010 SlimCore já carregado Este código não é realmente um erro. É um bom indicador de que o usuário está na nova arquitetura de otimização com SlimCore.
3002 24018 Nenhum SlimCore local O SlimCore não foi baixado com êxito no ponto de extremidade.
3004 24035 Plug-in não responsivo Tente reiniciar o Teams. Normalmente, esse é um erro transitório, em que o plug-in está ocupado preparando o mecanismo de mídia. Esse erro é diferente de 2000, em que um canal virtual não consegue estabelecer. No Erro 3004, há um transporte estabelecido, mas o Plug-in nunca respondeu ao Teams com um 'ClientHello'
3005 24043 Tempo limite do plug-in durante o download Falha ao baixar o MSIX em 2 minutos.
3007 24058 Tempo limite de carregamento O download ou a instalação do SlimCore expiraram (a Internet lenta ou o Serviço de Preparação do Aplicativo está ocupado).
3021 24170 Nenhum pacote SlimCore utilizável Alguns pacotes MSIX estão presentes (geralmente Framework), mas nenhuma combinação utilizável (geralmente sem o pacote MSIX do host). Algumas configurações de usuário estão impedindo instalações de host.
4000 ERROR_WINS_INTERNAL O WINS encontrou um erro ao processar o comando.
4390 ERROR_NOT_A_REPARSE_POINT Erro relacionado ao SlimCore MSIX em Thin Clients com Filtros de Gravação Unificados e sobreposições de disco RAM. Por favor, marque esta seção
12002 ERROR_INTERNET_TIMEOUT Problemas de conectividade com a Internet no ponto de extremidade. A solicitação HTTP atingiu o tempo limite. A ação recomendada para o usuário é executar a Ferramenta NAT e detectar problemas em sua rede para resolve-lo
12030 ERROR_INTERNET_CONNECTION_ABORTED Problemas de conectividade com a Internet no ponto de extremidade. A conexão com o servidor da CDN da Microsoft foi encerrada de forma anormal. A ação recomendada para o usuário é executar a Ferramenta NAT e detectar problemas em sua rede para resolve-lo
15615 1951 ERROR_INSTALL_POLICY_FAILURE Erro relacionado ao SlimCore MSIX. Para instalar este aplicativo, você precisa de uma licença de desenvolvedor do Windows ou um sistema habilitado para sideload. A chave de registro AllowAllTrustedApps pode estar definida como 0?
15616 ERROR_PACKAGE_UPDATING Erro relacionado ao SlimCore MSIX. 'O aplicativo não pode ser iniciado porque está sendo atualizado no momento'. Condição de corrida de ciclo de vida MSIX transitória, não uma falha de implantação forçada. O Windows retorna isso quando o plug-in tenta iniciar ou carregar o SlimCore enquanto o subsistema AppX/MSIX ainda está atualizando, registrando, reparando ou substituindo o pacote SlimCore no ponto de extremidade. Se a otimização for bem-sucedida, trate 15616 como uma condição com nova tentativa, em vez de uma falha de implantação. Investigue mais apenas se os usuários permanecerem em "SlimCore Media Not Connected" ou nunca for otimizado com o SlimCore.
15618 ERROR_PACKAGES_IN_USE Erro relacionado ao SlimCore MSIX. 'O pacote não pôde ser instalado porque os recursos que ele modifica estão em uso no momento'.
15700 APPMODEL_ERROR_NO_PACKAGE O processo não tem identidade de pacote. Não há alias para MsTeamsVdi em %LOCALAPPDATA%\Microsoft\WindowsApps. Os logs do Hub de Comentários são necessários ao reproduzir o erro (selecione Plataforma do Desenvolvedor como categoria e Implantação do aplicativo como subcategoria)
16389 E_FAIL relatadas pelo Gerenciador de Pacotes Geralmente o mesmo que carregar código de erro 5 (ERROR_ACCESS_DENIED). Provavelmente causado pela política BlockNonAdminUserInstall quando o usuário não é um Administrador. Confira este link para obter mais detalhes. O MDM do Intune também pode definir esse valor. Sob algumas condições, o Windows relata o erro 16389 (E_FAIL) como um erro genérico, portanto, BlockNonAdminUserInstall não é a única causa raiz - veja a descrição detalhada abaixo.

Usando o Visualizador de Eventos na VM para solução de problemas

Cada evento de conexão/desconexão é registrado no Visualizador de Eventos em execução na Máquina Virtual. O Visualizador de Eventos também pode exibir erros relacionados ao lado do cliente. Filtre por Origem (Microsoft Teams VDI) e ID do Evento (0) em Windows Logs\Application. Os códigos de erro podem ser encontrados na seção de logs do Teams para VDI .

Nota

Para poder filtrar por origem, você precisa executar este comando em uma janela elevada do PowerShell:

PS C:\Windows\system32> New-EventLog -LogName Application -Source "Microsoft Teams VDI"

Solução de problemas de erros de implantação de plug-in

As informações de diagnóstico podem ser encontradas nos logs de eventos detalhados no dispositivo do usuário. Após a instalação, MsTeamsPluginCitrix.dll é gravada na pasta CWA (aplicativo Citrix Workspace). Somente para a plataforma Citrix, as seguintes chaves no Endpoint (não VM) são criadas:

Chave Tipo de chave Nome da chave Valor da chave
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0 Cadeia de Caracteres VirtualDriverEx MicrosoftTeamsVDI
HKLM\SOFTWARE\WOW6432Node\Citrix\ICAClient\Engine\Configuration\Advanced\Modules\MicrosoftTeamsVDI Cadeia de Caracteres DriverNameWin32 MsTeamsPluginCitrix.dll

Para depurar instalações, você pode habilitar o log do instalador, mas então você deve usar msiexec manualmente e passar sinalizadores corretos. Por exemplo, se o plug-in não estiver instalado no momento, ele poderá ser instalado com logs: msiexec.exe /i MsTeamsPluginCitrix.msi /l*vx installer.log.txt.

Solução de problemas de erros de implantação do SlimCoreVdi MSIX

Verifique o preparo e o registro do SlimCore MSIX na seção de ponto de extremidade , pois determinados GPOs (políticas de grupo) podem impedir instalações de MSIX.

As informações de diagnóstico podem ser encontradas nos logs de eventos detalhados no dispositivo do usuário.

  1. Vá para o Visualizador de Eventos (Local) > Aplicativos e Serviços Logs > do Microsoft > Windows.

  2. Verifique se há logs disponíveis nestas categorias:

    • AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
    • >AppXDeployment-Server Microsoft-Windows-AppXDeploymentServer/Operational
  3. Revise os logs em AppXDeployment-Server.

Erro 16389

O erro 16389 (E_FAIL) geralmente é um erro em que a pilha Gerenciador de Pacotes do Windows/AppX encontrou alguma falha subjacente, mas só revelou o valor de E_FAIL genérico. A causa mais provável é a política BlockNonAdminUserInstall. Esta Política de CSP para ApplicationManagement gerencia a capacidade dos usuários não administradores de instalar pacotes de aplicativos do Windows, por exemplo, o SlimCore Host e o Framework.

Nota

O problema também pode ser causado quando a política de MDM ApplicationManagement/BlockNonAdminUserInstall (Intune Catálogo de Configurações → Implantação de Pacote de Aplicativos → Bloquear instalação de usuário não administrador) está definida como 1 (Habilitada) no ponto de extremidade. A política efetiva é lida de: HKLM\SOFTWARE\Microsoft\PolicyManager\current\device\ApplicationManagement\BlockNonAdminUserInstall = 1 (REG_DWORD). O Servidor de Implantação AppX retorna E_ACCESSDENIED (0x80070005) para o chamador (msrdc.exe, por exemplo). O plug-in VDI do Teams mostra isso como windows_error_16389 e aborta o registro do SlimCore → nova otimização não é inicializada → chamada retorna para não otimizado ou, se disponível, WebRTC.

Causa Probabilidade Observações
BlockNonAdminUserInstall Muito alto
AppLocker / WDAC Alto
Incompatibilidade de registro do SlimCore Host/FWK Alto Corrigido no plug-in 2026.29.1.4
Problema de registro multiusuário de quiosque compartilhado Alto Corrigido no plug-in 2026.29.1.4
Acesso à pasta temporária negado Medium-High

Erro 15615

O erro 15615 geralmente significa que o Gerenciador de Pacotes do Windows não pode instalar o pacote MSIX com o SlimCoreVdi.

  • Verifique se o ponto de extremidade confia na assinatura digital desse MSIX (acesse Detalhes de assinaturas > digitais de propriedades > do MSIX>). É uma assinatura válida da Microsoft para a loja, mas os clientes podem ter algo especial configurado.
  • Tente habilitar a política AllowAllTrustedApps.
  • Tente permitir aplicativos de sideload de fontes confiáveis que não são da loja.
    • No Windows 10, essa configuração está habilitada por padrão, portanto, modifique-a aqui se você a achar desabilitada: Atualização de configurações > e segurança > Para desenvolvedores > Sideload de aplicativos.
    • No Windows 11, essa configuração está habilitada por padrão: Configurações > Aplicativos > Configurações > avançadas do aplicativo Escolha onde obter aplicativos > Em qualquer lugar.

Coleção de logs

O registro em log pode ser encontrado nos seguintes locais:

  • No cliente (para SlimCores antigos antes da nova arquitetura dividida com Host e Estrutura):

    • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
    • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
  • No cliente (para novos SlimCores com arquitetura dividida com Host e Estrutura):

    • AppData\Local\Packages\Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe\LocalCache\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
    • AppData\Local\Packages\Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe\LocalCache\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
  • No servidor:

    • AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\skylib