Nova solução VDI para o Teams

A nova solução VDI para o Teams é uma nova arquitetura para otimizar a entrega de cargas de trabalho multimédia em ambientes de trabalho virtuais.

Componentes

Requisitos do sistema

Otimizar com a nova solução VDI para o Teams

Passo 1: Confirmar os pré-requisitos

1. Certifique-se de que tem a nova versão do Microsoft Teams 24193.1805.3040.8975 ou superior (para o Azure Virtual Desktop/Windows 365) e 24165.1410.2974.6689 ou superior para Citrix.
2. Ative a nova política do Teams, se necessário , para um grupo de utilizadores específico (está ativada por predefinição a nível global ao nível da organização).
3. Para o Citrix, tem de configurar a lista de permissões do Canal virtual , conforme descrito na secção Citrix Virtual channel allow list deste artigo.

Passo 2: Instalação do plug-in no ponto final

1. Para o Azure Virtual Desktop e Windows 365, o MsTeamsPluginAvd.dll é agrupado com o Cliente RD para Windows 1.2.5405.0 ou com a aplicação windows App Store 1.3.252 ou superior.

   • O plug-in encontra-se na mesma localização da pasta onde o Cliente rd está instalado. Está localizado em AppData\Local\Apps\Remote Desktop ou C:\Program Files (x86), consoante o modo em que foi instalado.
   • A aplicação windows App Store, uma vez que é baseada em MSIX, encontra-se em C:\Programas\WindowsApps. O acesso a esta pasta é restrito.

2. Para o Citrix CWA 2402 ou superior, MsTeamsPluginCitrix.dll podem ser instaladas:

   • Utilizar a interface de utilizador ao instalar o CWA:

     Na página Suplementos , selecione a caixa de verificação Instalar plug-in VDI do Microsoft Teams e, em seguida, selecione Instalar.

     Aceite o contrato de utilizador apresentado e prossiga com a instalação da aplicação Citrix Workspace.

     Nota

     A aplicação Citrix Workspace 2402 só apresenta a IU de instalação do plug-in numa nova instalação. Para que as atualizações no local também apresentem esta opção, é necessária a aplicação Citrix Workspace 2405 ou superior.

   • Através da linha de comandos ou scripts para dispositivos geridos com:

     C:\>CitrixWorkspaceApp.exe installMSTeamsPlugin

   • Os administradores também podem instalar o plug-in manualmente sobre qualquer CWA suportado existente (consulte Requisitos de Sistema) através de ferramentas como SCCM (utilize o tipo de implementação do pacote de aplicações do Windows) ou Intune (utilize a aplicação Linha de Negócio).

     Os administradores podem utilizar msiexec com sinalizadores adequados, conforme discutido no msiexec.

     Importante

     Pode encontrar a ligação de transferência msi de plug-in para clientes Citrix: MsTeamsPluginCitrix.msi.

O MSI de plug-in deteta automaticamente a pasta de instalação do CWA e coloca MsTeamsPluginCitrix.dll nessa localização:

• Os plug-ins não podem ser desclassificados, apenas atualizados ou reinstalados (reparados).
• A instalação por utilizador do CWA não é suportada.
• Se não for encontrado nenhum CWA no ponto final, a instalação será parada.

Passo 3: teste e registo msix do SlimCore no ponto final

O plug-in executa automaticamente este passo, sem intervenção do utilizador ou do administrador. O teste e o registo baseiam-se no Serviço de Preparação de Aplicações (ARS) no ponto final. É possível que a instalação do pacote MSIX seja bloqueada por chaves de registo definidas por um Política de Grupo ou por uma ferramenta de terceiros. Para obter uma lista completa das chaves de registo aplicáveis, veja How Política de Grupo works with packaged apps - MSIX (Como funciona o Política de Grupo com aplicações em pacote – MSIX).

As seguintes chaves de registo podem bloquear a instalação do novo pacote MSIX do motor de multimédia:

• BlockNonAdminUserInstall
• AllowAllTrustedApps
• AllowDevelopmentWithoutDevLicense

Estas três chaves de registo podem ser encontradas em qualquer uma das seguintes localizações no dispositivo do utilizador:

• HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock
• HKLM\SOFTWARE\Policies\Microsoft\Windows\Appx

Algumas políticas podem alterar estas chaves de registo e bloquear a instalação de aplicações na sua organização porque os administradores definem uma política restritiva. Algumas das políticas de GPO conhecidas que podem impedir a instalação incluem:

• Impedir que os utilizadores não administradores instalem aplicações do Windows em pacote.
• Permitir a instalação de todas as aplicações fidedignas (desativada).

Verificar se o ponto final está otimizado

Depois de cumprir todos os requisitos mínimos, iniciar o novo Teams pela primeira vez encontra-o ainda no modo otimizado para WebRTC por predefinição.

Pode marcar no cliente do Teams que otimizou com a nova arquitetura ao aceder às reticências (três pontos...) na barra superior e, em seguida, selecionar Definições > Acerca de. As versões do Teams e do cliente estão listadas aí.

• AvD SlimCore Media Optimized = Nova otimização com base no SlimCore.
• AvD Media Otimizado = Otimização legada com base no WebRTC.

O plug-in (MsTeamsPluginAvd.dll ou MsTeamsPluginCitrix.dll) é responsável por transferir eventualmente o motor de multimédia e o SlimCore, que é um pacote MSIX. Instala automaticamente sem privilégios de administrador ou reinícios no (por exemplo, o caminho exato varia):

C:\Program Files\WindowsApps\Microsoft.Teams.SlimCoreVdi.win-x64.2024.15_2024.15.1.5_x64__8wekyb3d8bbwe

O cliente de ambiente de trabalho remoto transfere o pacote x64 ou x86 SlimCore e o Citrix CWA transfere um pacote x86. Esta pasta está bloqueada, pelo que os utilizadores não têm acesso à mesma. Os administradores podem assumir a propriedade ao modificar ACLs, embora esta ação não seja recomendada. Em vez disso, utilize o PowerShell para listar as aplicações MSIX no ponto final:

PowerShellCopy

Get-AppxPackage Microsoft.Teams.SlimCore*

Uma amostra dos resultados que podem ser devolvidos da execução deste Powershell é:

Name              : Microsoft.Teams.SlimCoreVdi.win-x64.2024.32
Publisher         : CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US
Architecture      : X64
ResourceId        :
Version           : 2024.32.1.7
PackageFullName   : Microsoft.Teams.SlimCoreVdi.win-x64.2024.32_2024.32.1.7_x64__8wekyb3d8bbwe
InstallLocation   : C:\Program
                    Files\WindowsApps\Microsoft.Teams.SlimCoreVdi.win-x64.2024.32_2024.32.1.7_x64__8wekyb3d8bbwe
IsFramework       : False
PackageFamilyName : Microsoft.Teams.SlimCoreVdi.win-x64.2024.32_8wekyb3d8bbwe
PublisherId       : 8wekyb3d8bbwe
IsResourcePackage : False
IsBundle          : False
IsDevelopmentMode : False
NonRemovable      : False
IsPartiallyStaged : False
SignatureKind     : Developer
Status            : Ok

Se estiver otimizado, pode ver MsTeamsVdi.exe em execução no ponto final para o Azure Virtual Desktop/W365 (como um processo subordinado de msrdc.exe) ou Citrix (como um processo subordinado de wfica32.exe). Ao utilizar a Explorer processo, se selecionar msrdc.exe (ou wfica32.exe), selecione Mostrar o painel inferior em Ver e mude para o separador DLL, também pode ver o Plug-in (MsTeamsPluginAvd.dll ou MsTeamsPluginCitrix.dll) a ser carregado. Esta ação é um passo de resolução de problemas útil caso não esteja a obter a nova otimização.

Se ativar o painel inferior e mudar para o separador DLL, também poderá ver o Plug-in a ser carregado. Esta ação é um passo de resolução de problemas útil caso não esteja a obter a nova otimização.

Roaming de sessão e restabelecimento de ligações

O Novo Teams carrega o WebRTC ou o SlimCore no momento do lançamento. Se as sessões de ambiente de trabalho virtual estiverem desligadas (sem sessão iniciada, o Teams é deixado em execução na VM), o novo Teams não pode mudar as pilhas de otimização, a menos que seja reiniciada. Como resultado, os utilizadores podem estar no modo de contingência (não otimizado) se percorrerem entre diferentes dispositivos que não suportam a nova arquitetura de otimização (por exemplo, um dispositivo MAC que é utilizado no BYOD enquanto trabalha a partir de casa e um cliente magro gerido pela empresa no escritório). Para evitar este cenário, o Teams pede ao utilizador um diálogo modal a pedir para reiniciar a aplicação. Após o reinício, os utilizadores estão no modo de otimização do WebRTC.

Considerações sobre a rede

Certifique-se de que o dispositivo do utilizador tem conectividade de rede (UDP e TCP) ao ID de ponto final 11, 12, 47 e 127 descritos nos intervalos de URLs e endereços IP do Microsoft 365.

Arquitetura de rede

Instruções da arquitetura no diagrama:

1. Inicie o novo Teams.
2. O cliente do Teams autentica-se nos serviços do Teams. As políticas de inquilino são enviadas para o cliente do Teams e as configurações relevantes são reencaminhadas para a aplicação.
3. O Teams deteta que está em execução num ambiente de trabalho virtual e instancia o serviço vdibridge interno.
4. O Teams abre um canal virtual seguro no servidor.
5. O protocolo RDP ou HDX transporta o pedido para o Cliente RD ou a aplicação Citrix Workspace que carregou anteriormente o MsTeamsPlugin (componente de canal virtual do lado do cliente).
6. A aplicação Cliente RD ou Citrix Workspace gera um novo processo chamado MsTeamsVdi.exe, que é o novo motor de multimédia (SlimCore) utilizado para a nova otimização.
7. O motor de multimédia SlimCore (no cliente) e o msteams.exe (no ambiente de trabalho virtual) têm agora um canal bidirecional e podem começar a processar pedidos multimédia.

Chamadas de utilizador

8. Peer A seleciona o botão de chamada. MsTeamsVdi.exe comunica com os serviços do Microsoft Teams no Azure, estabelecendo um caminho de sinalização ponto a ponto com o Elemento B. MsTeamsVdi.exe recolhe uma série de parâmetros de chamada suportados (codecs, resoluções, etc., que é conhecido como uma oferta SDP (Session Description Protocol). Estes parâmetros de chamada são depois reencaminhados através do caminho de sinalização para os serviços do Microsoft Teams no Azure e a partir daí para o outro elemento da rede.
9. A oferta/resposta SDP (negociação de passagem única) ocorre através do canal de sinalização e as verificações de conectividade ice (NAT e Firewall transversal com pedidos de enlace STUN) são concluídas. Em seguida, o suporte de dados Secure Real-time Transport Protocol (SRTP) flui diretamente entre MsTeamsVdi.exe e o outro elemento da rede (ou Reencaminhamentos de Transporte do Teams ou servidores de Conferência).

Os blocos IP para sinalização, suporte de dados, efeitos de fundo e outras opções estão descritos neste artigo.

Tipos de tráfego processados pelo SlimCore no ponto final

1. A conectividade dos fluxos de multimédia do Teams é implementada com o IETF Interactive Connectivity Establishment (ICE) padrão para procedimentos STUN e TURN.
2. Meios de comunicação em tempo real. Dados encapsulados no Protocolo RTP (Real-Time Transport Protocol) que suporta cargas de trabalho de partilha de áudio, vídeo e ecrã. Em geral, o tráfego de multimédia é altamente sensível à latência. Este tráfego tem de seguir o caminho mais direto possível e utilizar o UDP versus TCP como protocolo de camada de transporte, que é o melhor transporte para suportes de dados interativos em tempo real numa perspetiva de qualidade.

• Como último recurso, os suportes de dados podem utilizar TCP/IP e também ser túneis dentro do protocolo HTTP, mas não é recomendado devido a implicações de má qualidade.
• O fluxo RTP é protegido com SRTP, no qual apenas o payload é encriptado.

1. Sinalização. A ligação de comunicação entre o ponto final e os servidores do Teams, ou outros clientes, utilizada para controlar atividades (por exemplo, quando é iniciada uma chamada). A maioria do tráfego de sinalização utiliza o UDP 3478 com contingência para HTTPS, embora em alguns cenários (por exemplo, a ligação entre o Microsoft 365 e um Controlador de Limite de Sessão) utilize o protocolo SIP. É importante compreender que este tráfego é muito menos sensível à latência, mas pode causar interrupções do serviço ou tempos limite de chamada se a latência entre os pontos finais exceder vários segundos.

Consumo de largura de banda

O Teams foi projetado para dar a você a melhor experiência de compartilhamento de áudio, vídeo e conteúdo, independentemente das condições da sua rede. Quando a largura de banda é insuficiente, o Teams prioriza a qualidade do áudio em vez da qualidade do vídeo. Quando a largura de banda não é limitada, o Teams otimiza a qualidade dos suportes de dados, incluindo áudio de alta fidelidade, até 1080p de resolução de vídeo e até 30 fps (fotogramas por segundo) para vídeo e conteúdo. Para saber mais, leia Requisitos de largura de banda

Qualidade dos serviços (QoS)

Implemente definições de QoS para pontos finais e dispositivos de rede e determine como pretende processar o tráfego de multimédia para chamadas e reuniões.

• Como pré-requisito, ative a QoS globalmente no Teams Administração Center. Veja Configurar qoS no centro de administração do Teams para obter detalhes sobre como ativar os marcadores Inserir Qualidade de Serviço (QoS) para definições de tráfego de multimédia em tempo real .

  Intervalos de portas iniciais recomendados:

  Tipo de tráfego de mídia	Intervalo de portas de origem do cliente	Protocolo	Valor DSCP	Classe DSCP
  Áudio	50,000 - 50,019	TCP/UDP	46	Expedited Forwarding (EF)
  Vídeo	50,020 - 50,039	TCP/UDP	34	Assured Forwarding (AF41)
  Partilha de aplicações ou ecrãs	50,040 = 50.059	TCP/UDP	18	Assured Forwarding (AF41)

• Para obter informações sobre como configurar marcas DSCP para pontos finais do Windows, veja Implementar QoS em clientes do Teams.

  Nota

  Qualquer marcação baseada em pontos finais tem de ser aplicada ao MsTeamsVdi.exe, o processo que processa todas as descargas de multimédia no dispositivo do utilizador. Consulte o documento Manual de Procedimentos para obter mais informações sobre a QoS.

• Para obter informações sobre a implementação do QoS para routers, veja a documentação do fabricante.

• A definição de QoS em dispositivos de rede pode incluir alguns ou todos:

  • utilizar Controle de Acesso Listas baseados em portas (ACLs)
  • definir as filas QoS
  • definir marcas DSCP

Tecnologias que não são recomendadas com o Microsoft Teams no VDI

1. Rede VPN. Não é recomendado para o tráfego de multimédia.
2. Formadores de pacotes. Qualquer tipo de farejador de pacotes, inspeção de pacotes, proxies ou dispositivos de formador de pacotes não são recomendados para o tráfego de multimédia do Teams e podem degradar significativamente a qualidade.

Política do PowerShell do Microsoft Teams para otimização

Os cmdlets CsTeamsVdiPolicy permitiram aos administradores controlar o tipo de reuniões que os utilizadores podem criar ou as funcionalidades às quais podem aceder numa reunião especificamente num ambiente VDI, onde a otimização do WebRTC foi desativada com o motor de política do Parceiro VDI (Citrix Studio, modelo ADMX VMware HTML5 ou esta chave de registo para AVD e Windows 365).

As configurações de política predefinidas são:

• DisableCallsAndMeetings: Falso
• DisableAudioVideoInCallsAndMeetings: False

Esta política é agora expandida com um argumento adicional como o único ponto de configuração para controlar se um utilizador pode obter o novo modo de otimização baseado ou não no SlimCore (ou seja, os motores de política do Parceiro VDI não controlam o novo modo de otimização):

• VDI2Optimization: Ativado (valor predefinido)

Lista de funcionalidades com a nova otimização

Perfil de utilizador do SlimCore no ponto final

A nova solução para a VDI armazena dados específicos do utilizador no ponto final nas seguintes localizações, consoante o fornecedor:

• C:\users\<user>\AppData\Local\Microsoft\TeamsVDI\avd-default-<cloudname>\
• C:\users\<user>\AppData\Local\Microsoft\TeamsVDI\citrix-default-<cloudname>\

Os registos, configurações e modelos de IA ou ML (utilizados na supressão de ruído, estimativa de largura de banda, etc.) são guardados nesta localização. Se estas pastas forem removidas após o fim de sessão de um utilizador (por exemplo, clientes magros bloqueados sem perfis de roaming), MsTeamsVdi.exe as recria e transfere a configuração específica do utilizador (cerca de 6 MB de dados).

Processo de instalação e atualização do SlimCore em ambientes thin client bloqueados (opcional)

Por predefinição, o MsTeamsPlugin transfere e instala automaticamente a versão correta do motor de multimédia SlimCore sem intervenção do utilizador ou Administração. No entanto, os clientes em ambientes de rede restritos na sucursal podem optar por um processo de distribuição SlimCore alternativo, sem exigir que o ponto final consiga obter pacotes SlimCore através de https da CDN pública da Microsoft.

Passos de configuração

1. No ponto final do utilizador (cliente magro/cliente gordo), tem de criar a seguinte chave de registo:

   • Localização para Citrix: HKLM\SOFTWARE\WOW6432Node\Microsoft\Teams\MsTeamsPlugin
   • Localização do Azure Virtual Desktop/W365: HKLM\SOFTWARE\Microsoft\Teams\MsTeamsPlugin
   • Nome: MsixUrlBase
   • Tipo: REG_SZ
   • Dados: caminho UNC de armazenamento local ou de armazenamento de rede, como file://C:/Temp ou file://ComputerName/SharedFolder.

   A chave de registo define o URL base.

2. Além disso, os administradores têm de transferir a versão exata do Pacote MSIX do SlimCore a partir da CDN da Microsoft que corresponde à nova versão do Teams que está a planear implementar no futuro.

   Importante

   O pacote MSIX tem de corresponder à arquitetura ou bitness da aplicação Citrix Workspace (apenas x86) ou do Ambiente de Trabalho Remoto ou dos clientes da Aplicação Windows: Microsoft.Teams.SlimCoreVdi.<platform>-<architecture>.msix.

3. Coloque o MSIX numa pasta específica com a versão na localização especificada na chave de registo para preservar a estrutura. Por exemplo, C:\Temp\2024.4.1.9\Microsoft.Teams.SlimCoreVdi.win-x86.msix ou //ComputerName/SharedFolder/2024.4.1.9/.

   Nota

   Se o Plug-in não conseguir encontrar um pacote MSIX SlimCore no armazenamento local ou de rede, tenta transferi-lo automaticamente a partir da CDN pública da Microsoft como uma contingência.

Problemas conhecidos

• Neste momento, o AVD RemoteApps e as Aplicações Publicadas do Citrix não são suportados.
• A Proteção contra Captura de Ecrã (SCP) faz com que o ecrã do apresentador seja apresentado como um ecrã preto apenas com o cursor do rato na parte superior (conforme visto pelo lado de receção).
• As chamadas são largadas no Teams em execução no computador local que tem um periférico HID ligado se um utilizador iniciar um ambiente de trabalho virtual a partir desse mesmo computador local e iniciar sessão no Teams.
• A pré-visualização automática da câmara não é suportada neste momento (em Definições/Dispositivos ou durante uma chamada ao selecionar a seta para baixo no ícone da câmara).

Lista de permissões do canal virtual Citrix

A definição de política de lista de permissões de canal virtual no CVAD permite a utilização de uma lista de permissões que especifica quais os canais virtuais que podem ser abertos numa sessão do ICA. Quando ativado, todos os processos, exceto os canais virtuais incorporados do Citrix, têm de ser indicados. Como resultado, são necessárias mais entradas para que o novo cliente do Teams consiga ligar-se ao plug-in do lado do cliente (MsTeamsPluginCitrix.dll).

Com o Citrix Virtual Apps and Desktops 2203 ou posterior, a lista de permissões do canal virtual está ativada por predefinição. Estas predefinições negam o acesso aos novos canais virtuais personalizados do Teams, uma vez que a lista de permissões não inclui o novo nome do processo do Teams main.

O novo cliente do Teams necessita de três canais virtuais personalizados para funcionar: MSTEAMS, MSTEAM1 e MSTEAM2. Estes canais são acedidos por ms-teams.exe. Pode utilizar carateres universais para permitir que o ms-teams.exe canal virtual executável e personalizado:

• MSTEAMS,C:\Programas\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe
• MSTEAM1,C:\Programas\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe
• MSTEAM2,C:\Programas\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe

1. O suporte de carateres universais está disponível em:

   • VDA 2206 CR.
   • VDA 2203 LTSR a partir de CU2 em diante.

2. Os computadores VDA têm de ser reiniciados para que a política entre em vigor.

Compartilhamento de tela

Compatibilidade com o Citrix App Protection e o Microsoft Teams

Os utilizadores com a Proteção de Aplicações ativada ainda podem partilhar o ecrã e as aplicações enquanto utilizam a nova otimização. A partilha requer a versão 2402 ou superior do VDA e o CWA para Windows 2309.1 ou superior. Os utilizadores em versões inferiores acabam por partilhar um ecrã preto quando o módulo de Proteção de Aplicações está instalado e ativado.

Proteção contra Captura de Ecrã AVD e compatibilidade com o Microsoft Teams

Os utilizadores com a Proteção de Captura de Ecrã (SCP) ativada não podem partilhar os respetivos ecrãs ou aplicações. As outras pessoas na chamada só podem ver um ecrã preto. Se quiser permitir que os utilizadores partilhem o respetivo ecrã mesmo com o SCP ativado, tem de desativar a otimização do SlimCore na política do Teams Administração Center (para que o utilizador seja otimizado com o WebRTC) e definir a política SCP para Bloquear captura de ecrã no cliente.

Dashboard de Qualidade da Chamada no VDI

O Dashboard de Qualidade de Chamadas (CQD) permite que os Profissionais de TI utilizem dados agregados para identificar problemas de criação de problemas de qualidade de multimédia ao comparar estatísticas de grupos de utilizadores para identificar tendências e padrões. O CQD não está focado na resolução de problemas de chamadas individuais, mas na identificação de problemas e soluções que se aplicam a muitos utilizadores.

As informações de utilizador da VDI estão agora expostas através de várias dimensões e filtros. Consulte esta página para obter mais informações sobre cada dimensão.

Noções básicas da consulta

Uma consulta/relatório CQD bem formado contém os três parâmetros seguintes:

• Medição
• Dimensão
• Filter

Alguns exemplos de uma consulta bem formada seriam:

1. "Show me Poor Streams [Measurement] for VDI Users with the new Optimization [Dimension] for Last Month [Filter]."
2. "Show me Poor Appsharing [Measurement] by Total Stream Count [Dimension] for Last Month AND where First OR Second Client VDI mode was optimized [Filters]."

Também pode utilizar muitos valores de Dimensão e Medição como filtros. Pode utilizar filtros na consulta para eliminar informações da mesma forma que selecionaria uma Dimensão ou Medida para adicionar ou incluir informações na consulta.

O que a UNION faz

Por predefinição, os Filtros permitem-lhe filtrar as condições com o operador E. No entanto, existem cenários em que poderá querer combinar várias condições de Filtro para obter um resultado semelhante a uma operação OR. Por exemplo: para obter todos os fluxos de Utilizadores VDI, o UNION fornece uma vista distinta do conjunto de dados intercalado. Para usar o parâmetro UNION, insira texto comum no campo UNION nas duas condições de filtro que você deseja unir.

Localização do Chamador e do Callee

O CQD não utiliza os campos Chamador ou Callee, em vez disso, utiliza Primeiro e Segundo porque existem passos de intervenção entre o chamador e o chamador.

• Em primeiro lugar , o ponto final do servidor (por exemplo, o AV MCU ou o Servidor de Processador de Multimédia) se um servidor estiver envolvido no fluxo.
• O segundo é sempre o ponto final do cliente, a menos que seja um fluxo servidor-servidor.

Se ambos os pontos finais forem do mesmo tipo (por exemplo, uma chamada pessoa-a-pessoa), o primeiro e o segundo são definidos com base na ordenação interna da categoria do agente de utilizador para garantir que a ordenação é consistente.

Solução de problemas

• Não otimizado com o SlimCore e, em vez disso, verá:
  "Otimizado para Multimédia do Azure Virtual Desktop""
  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 é carregado pelo Cliente VDI com o Processo Explorer:
  • 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.
  3. Reinicie a nova 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.
  4. Se o problema persistir, marcar Visualizador de Eventos na VM para erros relacionados com vDI do Microsoft Teams (novo Teams 24123.X.X.X ou superior).

• Não otimizado com o SlimCore e, em vez disso, verá: "Azure Virtual Desktop SlimCore Media Not Connected" ou "Citrix SlimCore Media Not Connected".

  • Veja a secção Resolução de problemas de erros de implementação do MSIX SlimCoreVdi . Os erros relacionados com MSIX ou AppX são os motivos mais prováveis para este erro.

Novos 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.

Vdi_debug.txt é o ficheiro de main para informações relacionadas com a VDI

• 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 CDN da Microsoft e aprovisioná-lo ou aprovisioná-lo no 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:

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 de Evento (0). Os códigos de erro podem ser encontrados na secção Novos registos do Teams para 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. Apenas para a plataforma Citrix, são criadas as seguintes chaves no Ponto Final (não na VM):

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 como este: 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 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 a assinatura digital desse MSIX é considerada fidedigna pelo Ponto Final (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 caso esteja 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:
  • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
  • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
• No Servidor:
  • AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\skylib