Partilhar via


Resolução de problemas do VDI 2.0

Ao resolver problemas com a nova otimização baseada em Slimcore para o Microsoft Teams, precisa de saber se os utilizadores estão otimizados com a pilha WebRTC legada. Também podem acabar no modo de contingência "SlimCore Media Not Connected" (ou composição do lado do servidor).

  • Não otimizado com o SlimCore e, em vez disso, verá:
    "Azure Multimédia de Ambiente de Trabalho Virtual Otimizado"
    "Citrix HDX Otimizado"

    • Os Códigos de Erro 2000 ("Sem Plug-in") e 2001 ("Canal Virtual não disponível") são as causas mais prováveis.
    1. Certifique-se de que a sua "lista de Permissões de Canal Virtual" está configurada corretamente para permitir o MSTEAMS, MSTEAM1 MSTEAM2.
    2. Certifique-se de que o ponto final tem o plug-in e que o Cliente VDI com Processo Explorer o carrega:
    • Execute o explorador de processos.
    • Ative o painel inferior e mude para o separador DLL.
    • No Azure Virtual Desktop, procure o processo de msrdc.exe e certifique-se de que o MsTeamsPluginAvd.dll é carregado.
    • No Citrix, procure o processo de wfica32.exe e certifique-se de que o MsTeamsPluginCitrix.dll está carregado.
    1. Reinicie a aplicação Teams. Requer dois reinícios para fazer a transição do WebRTC para o SlimCore, quando o plug-in é detetado pela primeira vez.
    2. Se o problema persistir, marcar Visualizador de Eventos na máquina virtual (VM) para erros relacionados com vDI do Microsoft Teams (Teams 24123.X.X.X ou superior).
  • Não otimizado com o SlimCore e, em vez disso, verá: "Azure Suporte de Dados SlimCore de Ambiente de Trabalho Virtual Não Ligado" ou "Citrix SlimCore Media Não Ligado".

Registos do Teams para VDI

Os registos do Teams podem ser recolhidos ao selecionar Ctrl+Alt+Shift+1 enquanto executa o Teams numa VM. Esta ação produz uma pasta ZIP na pasta Transferências. No ficheiro PROD-WebLogs-*.zip, procure a pasta Core.

Azure Virtual Desktop/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® Remote Desktop", "pluginVersion": "2024.14.01.1", "screenShareFallback": true} "vdiConnectedState": {"connectedStack": "remote"}, "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 se ligou com êxito ao ponto final remoto através do canal virtual. Não significa necessariamente que a pilha de chamadas foi inicializada com êxito, pelo que o utilizador ainda pode deparar-se com falhas relacionadas com chamadas, como não conseguir iniciar uma chamada.
    • connectedStack: local indica que a ligação do canal virtual falhou. O utilizador está agora no modo de contingência.
  • vdiVersionInfo fornece informações úteis para o cliente do Teams e o ponto final.
    • bridgeVersion está associada à versão do cliente de ambiente de trabalho do Teams em execução na VM.
    • remoteSlimcroreVersion é a versão do SlimCore VDI que está disponível no ponto final.
    • nodeId é um ID exclusivo associado ao ponto final.
    • clientOsVersion é a versão do SO para o ponto final.
    • rdClientVersion é a versão do cliente de ambiente de trabalho remoto em execução no ponto final, que é utilizado para ligar à VM.
    • rdClientProductName é o nome do cliente de ambiente de trabalho remoto em execução no ponto final.
    • pluginVersion é a versão do plug-in que está integrada no cliente de ambiente de trabalho remoto.

Diagnostics-logs.txt pode estar em weblogs\user(..)

Para investigar mais aprofundadamente problemas relacionados com a ligação VDI, a utilização do palavra-chave vdiBRidgeEventsHandler fornece os registos dos processamentos de eventos de ligação e desligamento vdiBridge, conforme mostrado (no Processamento de eventos ligados) no exemplo seguinte de uma ligação com êxito à 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 ligação

Se existir um erro de ligação, o código de erro pode ser encontrado na linha de registo que contém "loadErrc" e "deployErrc". Um erro de implementação (também conhecido como install_error) é um erro que ocorre quando o plug-in estava a tentar transferir o pacote MSIX do SlimCore a partir da Rede de Entrega de Conteúdos da Microsoft. Em seguida, o plug-in tenta testar ou aprovisionar o pacote para o ponto final com o Serviço de Preparação de Aplicações para AppX. Um erro de carregamento é um erro que ocorre quando o plug-in tentou iniciar MsTeamsVdi.exe e estabelecer uma Chamada de Procedimento Remoto (RPC) para o mesmo.

O código registado aqui tem de ser mapeado com esta tabela:

loadErrc deployErrc Definição Observações
0 0 OK Não é um erro. Êxito de 'SlimCore Connected'
5 43 ERROR_ACCESS_DENIED MsTeamsVdi.exe processo falhou no arranque. A ativação de BlockNonAdminUserInstall pode causar este erro. Em alternativa, o ponto final pode estar ocupado a registar vários pacotes MSIX após o início de sessão de um utilizador e não terminou o registo de SlimCoreVdi.
404 3235 HTTP_STATUS_NOT_FOUND Problema de publicação: o pacote MSIX do SlimCore não foi encontrado na Rede de Entrega de Conteúdos.
1260 10083 ERROR_ACCESS_DISABLED_BY_POLICY Normalmente, este erro significa que Gerenciador de Pacotes do Windows não consegue instalar o pacote MSIX do SlimCore. Visualizador de Eventos pode mostrar o código de erro hexadecima 0x800704EC. As Políticas appLocker podem causar este código de erro. Pode desativar o AppLocker ou adicionar uma exceção para pacotes SlimCoreVdi na Política de Segurança Local –> Políticas de Controlo de Aplicações –> AppLocker. Selecione o Passo 3 em "Otimizar com a nova solução VDI para o Teams".
1460 11683 ERROR_time MsTeamsVdi.exe processo falhou no arranque (tempo limite de 60 segundos).
1722 RPC_S_SERVER_UNAVAILABLE "O servidor RPC está indisponível" MsTeamsVdi.exe erro relacionado.
2000 16002 Sem Plug-in O ponto final não tem o MsTeamsPlugin ou, se o tiver, não foi carregado (marcar com o Processo Explorer).
2001 Canal Virtual Não Disponível Erro no WFAPI citrix VDA (agente de entrega virtual).
2003 16026 Os Canais Virtuais Personalizados (MSTEAMS, MSTEAM1 e MSTEAM2) estão bloqueados devido a uma política do Citrix Studio Reveja a secção citrix virtual channel allow list do artigo VDI 2.0.
2005 16043 O Teams está a ser executado como uma Aplicação Publicada (Citrix) ou RemoteApp (AVD/Windows 365) Atualmente, este modo não é suportado – o Teams não carrega o SlimCore neste caso e os utilizadores estão sempre otimizados com o WebRTC.
3000 24002 Implementação do SlimCore não necessária Este código não é realmente um erro. É um bom indicador de que o utilizador está na nova arquitetura de otimização com o SlimCore.
3001 24010 SlimCore já carregado Este código não é realmente um erro. É um bom indicador de que o utilizador está na nova arquitetura de otimização com o SlimCore.
3004 24035 Plug-in irresponsivo Experimente reiniciar a sessão RDP (protocolo de ambiente de trabalho remoto) ou ICA (arquitetura de computação independente).
3005 24043 Tempo limite do plug-in excedido durante a transferência Falha ao transferir o MSIX no prazo de 2 minutos.
3007 24058 Tempo limite de carregamento O tempo limite de transferência ou instalação do SlimCore foi excedido (a Internet lenta ou o Serviço de Preparação de Aplicações está ocupado).
4000 ERROR_WINS_INTERNAL O WINS encontrou um erro ao processar o comando.
4390 ERROR_NOT_A_REPARSE_POINT Erro relacionado com MSIX do SlimCore em Clientes Dinâmicos com Filtros de Escrita Unificados e sobreposições do Disco RAM. Marcar esta secção
15615 1951 ERROR_INSTALL_POLICY_FAILURE Erro relacionado com MSIX do SlimCore. Para instalar esta aplicação, precisa de uma licença de programador do Windows ou de um sistema com sideload ativado. A regkey AllowAllTrustedApps pode estar definida como 0?
15616 ERROR_PACKAGE_UPDATING Erro relacionado com o MSIX do SlimCore "Não é possível iniciar a aplicação porque está atualmente a atualizar".
15700 APPMODEL_ERROR_NO_PACKAGE O processo não tem identidade de pacote. Não existe nenhum alias para MsTeamsVdi em %LOCALAPPDATA%\Microsoft\WindowsApps. Os registos do Hub de Comentários são necessários ao reproduzir o erro (certifique-se de que seleciona Plataforma de Programador como a categoria e Implementação de aplicações como subcategoria)
16389 E_FAIL comunicado pelo Gestor de Pacotes Normalmente, o mesmo que Carregar código de erro 5 (ERROR_ACCESS_DENIED). Provavelmente causado pela política BlockNonAdminUserInstall quando o utilizador não é um Administração. Consulte esta ligação para obter mais detalhes.

Utilizar Visualizador de Eventos na VM para resolução de problemas

Todos os eventos de ligação/desconexão são registados no Visualizador de Eventos em execução na Máquina Virtual. O Visualizador de Eventos também pode apresentar erros relacionados com o lado do cliente. Filtre por Origem (VDI do Microsoft Teams) e ID do Evento (0) em Registos do Windows\Aplicação. Os códigos de erro podem ser encontrados na secção Registos do Teams para VDI .

Nota

Para poder filtrar por Origem, tem de executar este comando a partir de uma janela elevada do PowerShell:

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

Resolver erros de implementação do Plug-in

As informações de diagnóstico podem ser encontradas nos registos de eventos detalhados no dispositivo do utilizador. Após a instalação, MsTeamsPluginCitrix.dll é escrito na pasta CWA (aplicação Citrix Workspace). Apenas para a plataforma Citrix, são criadas as seguintes chaves no Ponto Final (não na VM):

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, pode ativar o registo do instalador, mas, em seguida, tem de utilizar o msiexec manualmente e passar os sinalizadores corretos. Por exemplo, se o plug-in não estiver atualmente instalado, pode ser instalado com registos: msiexec.exe /i MsTeamsPluginCitrix.msi /l*vx installer.log.txt.

Resolver erros de implementação do MsIX SlimCoreVdi

Certifique-se de que revê o teste e o registo MSIX do SlimCore na secção de ponto final , uma vez que determinados GPOs (políticas de grupo) podem impedir instalações MSIX.

As informações de diagnóstico podem ser encontradas nos registos de eventos detalhados no dispositivo do utilizador.

  1. Aceda ao Visualizador de Eventos (Local) > Applications and Services Logs > Microsoft > Windows.

  2. Verifique se existem registos disponíveis nestas categorias:

    • AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operacional
    • >AppXDeployment-Server Microsoft-Windows-AppXDeploymentServer/Operational
  3. Reveja os registos em AppXDeployment-Server.

Erro 15615

Normalmente, o erro 15615 significa que o Gerenciador de Pacotes do Windows não consegue instalar o pacote MSIX com o SlimCoreVdi.

  • Certifique-se de que o Ponto Final confia na assinatura digital desse MSIX (Aceda a MsIX > Properties > Digital signatures Details > ). É uma assinatura Microsoft válida, mas os clientes podem ter algo especial configurado.
  • Experimente ativar a política AllowAllTrustedApps.
  • Tente permitir o sideload de aplicações de origens não arquivo fidedignas.
    • No Windows 10, esta definição está ativada por predefinição, por isso modifique-a aqui se a encontrar desativada: Atualização de Definições > e Segurança > para aplicações > sideload para programadores.
    • No Windows 11, esta definição está ativada por predefinição: Definições Aplicações >> Definições avançadas > da aplicação Selecione onde obter aplicações > em Qualquer Lugar.

Recolha de registos

O registo pode ser encontrado nas seguintes localizações:

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

    • 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 Framework):

    • 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