Atualizar para o novo Teams para infraestrutura de Área de Trabalho Virtualizada (VDI)

  • Artigo
  • Aplica-se a:
    Microsoft Teams

Este artigo descreve os requisitos e limitações de usar o novo cliente do Microsoft Teams em um ambiente virtualizado.

Comunicado importante para o Teams clássico para VDI

O clássico Teams para VDI chegará ao fim da disponibilidade em 30 de junho de 2024. Para obter mais informações, confira: Fim da disponibilidade para o cliente clássico do Teams

Após essa data, os usuários não poderão usar o Teams clássico, mas, em vez disso, serão solicitados a mudar para o novo Teams. Recomendamos que você atualize para o novo Teams hoje.

Nota

O Novo Teams para VDI agora está geralmente disponível para clientes em nuvens públicas, GCC, GCC High e Nuvem governamental do DoD.

Requisitos

Para que o novo Teams seja instalado com êxito, você precisa da versão 23306.3314.2555.9628 ou superior. Além disso, as máquinas virtuais devem atender aos requisitos mínimos listados aqui:

Requisito Versão
Windows - Windows 10.0.19041 ou superior
– Windows Server 2019 (10.0.17763)
– Windows Server 2022 (10.0.20348) ou superior
- Windows Server 2016 NÃO há suporte. Planejar atualizações.
- Estrutura do WebView2 necessária em ambientes multiusuários do Windows Server e Windows 10/11
Webview2 Versão mínima: 90.0.818.66. Saiba mais: Gerenciamento enterprise dos Runtimes do WebView2
Aplicativo Clássico do Teams Versão 1.6.00.4472 ou posterior para ver o alternância Experimentar o novo Teams. Importante: o Classic Teams é apenas um requisito se você quiser que os usuários possam alternar entre o Teams clássico e o novo Teams. Esse pré-requisito é opcional se você quiser apenas que seus usuários vejam o novo cliente do Teams.
Configurações Ative a configuração Mostrar Faixas de Notificação em Notificações > do Sistema > Microsoft Teams para receber Notificações do Teams.
Sideload do aplicativo habilitado Verifique se o sideload está habilitado em todos os computadores em que você instala. Saiba mais: Aplicativos LOB (sideload line of business) em dispositivos cliente Windows
Excluir antivírus e DLP Adicione novas equipes a aplicativos antivírus e DLP para que o Teams possa começar corretamente.
Saiba mais: Excluir aplicativos antivírus e DLP de bloquear o Teams

Requisitos do provedor de virtualização

Atualmente, o novo Teams na VDI com otimização de áudio/vídeo (AV) é certificado com Áreas de Trabalho Virtuais do Azure, Windows 365, Citrix e VMware.

Examine as informações nesta seção para garantir que você atenda a todos os requisitos para a funcionalidade adequada.

Área de Trabalho Virtual do Azure

A Área de Trabalho Virtual do Azure fornece otimização de AV para o Teams no VDI. Para saber mais sobre requisitos e instalação, confira Usar o Teams na Área de Trabalho Virtual do Azure.

As seguintes versões mínimas são necessárias para dar suporte ao novo cliente do Teams:

  • Cliente da Área de Trabalho Remota para Windows 1.2.1755
  • Cliente da Área de Trabalho Remota para Mac 10.7.7
  • Serviço de Redirecionamento webRTC 1.1.2110.16001

A Microsoft recomenda usar as versões mais recentes disponíveis.

Além disso, você deve implantar a seguinte chave de registro na área de trabalho virtual para que o novo cliente do Teams seja otimizado:

HKLM\SOFTWARE\Microsoft\Teams:

  • Nome: IsWVDEnvironment
  • Tipo: DWORD
  • Valor: 1

Windows 365

Windows 365 usa a otimização de AV fornecida pela Área de Trabalho Virtual do Azure para garantir experiências ideais do Teams de PCs de nuvem. Para saber mais sobre os requisitos e a instalação, confira Usar o Teams no Cloud PC.

As imagens Windows 10/11 na galeria são pré-configuradas com componentes de otimização necessários. Quando você instala e usa o Microsoft Teams no computador na nuvem, obtém uma experiência otimizada. Uma nova imagem com o novo cliente do Teams será adicionada à galeria em algumas semanas.

Se você quiser criar imagens personalizadas que incluam otimizações para o Microsoft Teams, você precisa executar as etapas descritas em Create uma imagem personalizada do Cloud PC para dar suporte ao Microsoft Teams.

As seguintes versões mínimas são necessárias para dar suporte ao novo cliente do Teams:

  • Cliente da Área de Trabalho Remota para Windows 1.2.1755
  • Cliente da Área de Trabalho Remota para Mac 10.7.7
  • aplicativo do Windows 365 para Windows por meio da Microsoft Store

Além disso, você deve implantar a seguinte chave de registro na área de trabalho virtual para que o novo cliente do Teams seja otimizado:

HKLM\SOFTWARE\Microsoft\Teams:

  • Nome: IsWVDEnvironment
  • Tipo: DWORD
  • Valor: 1

Requisitos de Citrix Virtual Apps and Desktops e Citrix DaaS

As seguintes versões mínimas são necessárias para dar suporte ao novo cliente do Teams:

Aplicativo Citrix Workspace:

  • Windows 2203 LTSR (e qualquer CU)
  • Windows 2302 CR
  • Linux 2207
  • Mac 2302
  • Chrome/HTML5 2301

VDA (Agente de Entrega Virtual do Citrix):

  • 2203 LTSR (e qualquer CU)
  • 2212 CR
  • 1912 CU6 (mas cu mais recente recomendado - observe que o compartilhamento de aplicativos não tem suporte em 1912)

Além disso, você deve implantar a seguinte chave de registro no VDA para que o novo cliente do Teams seja otimizado:

  • Local: HKLM\SOFTWARE\WOW6432Node\Citrix\WebSocketService
  • Chave (REG_Multi_SZ): ProcessWhitelist
  • Valor: msedgewebview2.exe

Se essa chave de registro estiver ausente, o novo cliente do Teams funcionará no modo não otimizado (renderização do lado do servidor). Esse regkey não é mais necessário se você estiver usando o VDA 2402 (marcar aqui para obter mais detalhes).

Nota

Atualmente, há suporte para aplicativos virtuais Citrix (também conhecidos como aplicativos publicados) com o VDA 2402 LTSR.

Para obter mais informações, saiba mais em Otimização para o Microsoft Teams.

Requisitos do VMware Horizon e do Workspace ONE

As seguintes versões mínimas são necessárias para dar suporte ao novo cliente do Teams:

  • Horizonte 8 2111 ESB (8.4)

Para saber mais sobre os requisitos e instruções mais recentes, incluindo como configurar a otimização de mídia para o Teams, consulte Configurando a Otimização de Mídia para o Microsoft Teams.

Implantar o novo cliente do Microsoft Teams

Para implantar o novo cliente do Microsoft Teams em sua organização, selecione uma das opções a seguir.

Importante

Você deve usar a versão mais recente do bootstrapper.exe. Se você tiver baixado o .exe anteriormente, verifique se você tem a versão mais recente exibindo Detalhes de Propriedades >> Versão do produto em sua versão e compare-a com as propriedades no download mais recente.

Nota

Verifique se você tem esses KBs em seu sistema, pois eles abordam muitas configurações de política que restringem o download e a instalação do novo Teams.

  1. Se estiver usando Windows 10 ou 11, verifique se você está instalando o patch de KB apropriado Windows 10: 26 de outubro de 2023 – KB5031445 (BUILD do sistema operacional 19045.3636) ou Windows 11: 26 de outubro de 2023 – KB5031445 (Compilação do sistema operacional 22621.2506). Caso contrário, quando o GPO AllowAllTrustedApps é definido como false e o problema mencionado na seção "Recursos atualmente não disponíveis e conhecidos na VDI com o novo Teams" deste artigo pode ocorrer (o New Teams não é iniciado para usuários fazendo logon em áreas de trabalho virtuais não persistentes ou o aplicativo não está visível no Menu Iniciar.
  2. Se o GPO BlockNonAdminUserInstall for definido como true, os usuários poderão enfrentar o problema mencionado na seção "Recursos atualmente não disponíveis e conhecidos na VDI com o novo Teams" podem ocorrer (o New Teams não é iniciado para usuários fazendo logon em áreas de trabalho virtuais não persistentes ou o aplicativo NÃO está visível no Menu Iniciar). Verifique se você tem o respectivo KB para o sistema operacional:
  • KB5035942 (Windows 11 versão 22H2 e 23H2, todas as edições)
  • KB5035941 (Windows 10 qualquer versão, todas as edições)
  • KB5036909 (Windows Server 2022)

Opção 1: desinstalar o cliente clássico do Teams e instalar o novo

Maneira recomendada de implantar novas Equipes na VDI. O método de "implantação em massa" ou direto é usado para essa opção. Saiba mais em Massa implantar o novo cliente de área de trabalho do Microsoft Teams.

Usar o comando teamsbootstrapper.exe -p sempre garante que o novo cliente do Teams mais recente esteja instalado.

Uma distribuição em fases e controlada pode ser obtida expandindo seletivamente as novas atribuições de catálogo/grupo de entrega de computadores para mais usuários.

Os administradores também podem usar um MSIX de equipes locais para provisionar o novo Teams. Essa opção minimiza a quantidade de largura de banda usada para a instalação inicial. O MSIX pode existir em um caminho local ou UNC.

  1. Baixe o instalador de .exe..
  2. Baixe o MSIX:
    - MSIX x86
    - MSIX x64
    - ARM64.
  3. Abra o Prompt de Comando como um Administração.
  4. Dependendo de onde o MSIX está localizado, siga as seguintes etapas:

Para o caminho local, insira:.\teamsbootstrapper.exe -p -o "c:\path\to\teams.msix"

Exemplo:

Local do caminho para instalador offline

Para UNC, insira:.\teamsbootstrapper.exe -p -o "\unc\path\to\teams.msix"

Exemplo:

local offline usando unc

Opção 2: instalar ambos os aplicativos 'lado a lado'

Deixe o usuário alternar entre eles usando o alternância no canto superior esquerdo da interface do usuário do Teams. Você pode controlar quem vê o alternância configurando a política teams Administração Center policy Teams update policy.

Se o alternância estiver sendo usado para a nova distribuição de cliente do Teams, os administradores deverão garantir que os ambientes de VDI atendam aos requisitos mínimos descritos aqui: Solucionar problemas de instalação no novo cliente do Teams.

Se os administradores de TI definirem restrições para MSIX ou implantar GPOs, isso poderá impedir que os usuários baixem e instalem o aplicativo. Se as restrições estiverem em vigor, o usuário poderá ver erros como este:

erro com políticas de organização.

Importante

O método "lado a lado" só tem suporte em ambientes persistentes. O Classic Teams 1.7.00.7956 ou superior suprimirá o alternância do alternador de aplicativo independentemente do valor da política do Teams Administração Center quando o Teams clássico estiver em execução em um ambiente não persistente, em que não persistente é detectado com base na pasta de instalação do MSI clássico do Teams, C:\Arquivos de Programa (x86).

Equipes Clássicas versus novos instaladores do Teams em ambientes de VDI

O cliente clássico do Teams e o novo cliente do Teams têm diferentes locais de instalação e requisitos de gerenciamento de perfil. É importante entender as diferenças e planejar de acordo.

Formato do instalador Instalar o local Atualização automática
MSI clássico do Teams com o sinalizador ALLUSERS=1 C:\Arquivos de Programa (x86)\Microsoft\Teams Desabilitado
Equipes Clássicas .EXE %localappdata%/Microsoft/Teams Habilitado
Novo bootstrapper do Teams .EXE Teamsbootstrapper.exe é um instalador online de wrapper leve com uma interface de linha de comando sem cabeça. Ele permite que os administradores 'provisionem' (instale) o aplicativo para todos os usuários em um determinado computador de destino/.
Ele instala o pacote MSIX do Teams em um computador de destino, certificando-se de que o Teams possa interoperar corretamente com o Office e outros softwares da Microsoft.
C:\Program Files\WindowsApps\PublisherName.AppName_AppVersion_architecture_PublisherID

Exemplo
C:\Arquivos do Programa\WindowsApps\MSTeams.23306.3314.2555.9628_x64_8wekyb3d8bbwe		 Habilitado. Ele pode ser desabilitado por meio de regkey. Saiba mais: Desabilitar o novo update automático do Teams

Solução de problemas de novos erros de implantação do Teams

Os administradores podem confiar no código de erro teamsbootstrapper.exe que descreve o problema. Se o código de erro não fornecer informações suficientes, mais informações de diagnóstico poderão ser encontradas nos logs de eventos detalhados.

  1. Acesse os logs de aplicativos e serviços > do Visualizador de Eventos (local)> Microsoft > Windows.
  2. Verifique se há logs disponíveis nessas categorias:
  • AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
  • >AppXDeployment-Server Microsoft-Windows-AppXDeploymentServer/Operational
  1. Examinar logs em AppXDeployment-Server

Saiba mais aqui: códigos de erro comuns

Teamsbootstrapper.exe códigos de erro comuns Mais informações
0x80070057 O comando bootstrapper não tem o caminho completo (evite URIs usando .). Experimente o caminho completo em vez disso (por exemplo, c:\temp\MSTeams-x64.msix).
0x80070032 Um erro provável no caminho UNC. Tente copiar o MSIX para uma pasta local.
0x80004004 Pode haver um regkey 'maglevInstallationSource' deixado para trás no regkey HKLM\Software\WoW6432Node\Microsoft\Office\Teams. Tente excluí-lo e reattempting a instalação.

Instruções de instalação do Windows Server 2019

Para o Windows Server 2019, o único método de instalação com suporte é:

Dism /Online /Add-ProvisionedAppxPackage /PackagePath:<MSIX package path> /SkipLicense

Verifique se o sideload está habilitado e se o WebView2 está instalado. Consulte a seção 'Requisitos' acima.

O comando /SkipLicense é necessário porque o pacote MSIX não é considerado um "Pacote de Loja" (já que não foi baixado do repositório). Portanto, para que o comando de instalação do Dism tenha êxito, você precisa habilitar essa política também durante o tempo de instalação: Modelos administrativos de configuração > do computador Implantação > do Pacote de Aplicativos de Componentes >do Windows Permitir que todos os aplicativos confiáveis sejam instalados>.

Limitações conhecidas:

  • O Classic Teams no Windows Server 2019 não está exibindo o alternância do alternador de aplicativos se a versão clássica do Teams for inferior a 1.6.00.33567
  • O Novo Teams no Windows Server 2019 atualmente não é compatível com o FSLogix e não é iniciado. Consulte problemas conhecidos do FSLogix para obter mais detalhes.

Integração de presença do Outlook ao Novo Teams no Windows Server 2019

Para que o Outlook exiba corretamente status de presença, as seguintes etapas são necessárias na imagem dourada:

  1. Instale em todo o computador (ALLUSERS=1) o recurso 'Windows 10 1809 e Windows Server 2019 KB5035849 240209_02051 Preview.msi'.
  2. Abra seu Política de Grupo Editor. Navegue até Configuração do Computador\Modelos Administrativos\KB5035849 240209_02051 Versão prévia do recurso\Windows 10, versão 1809 e Windows Server 2019. Altere o valor dessa Configuração para Habilitado.
  3. Instale KB5035849 atualização cumulativa de março de 2024 do Catálogo de Atualizações da Microsoft ou do WSUS para Empresas.
  4. Instale em todo o computador (ALLUSERS=1) o 'MSTeamsNativeUtility.msi'.
  5. Reinicialize a máquina virtual.
  6. Instale o novo Teams 24033.811.2738.2546 ou superior, usando Dism conforme descrito na seção acima.

Nota

As etapas 1, 2, 3, 4 e 5 são necessárias apenas uma vez. As manutenções de imagem dourada subsequentes não precisarão dessas etapas repetidas.

Importante

O Outlook deve ser iniciado após o lançamento do Novo Teams para que a presença seja mostrada corretamente.

Remover o novo Teams para todos os usuários

Para desinstalar e desprovisionar o novo Teams para todos os usuários, use o seguinte comando:

./teamsbootstrapper -x

Esse comando desativa e desprovisiona o novo Teams para todos os usuários. O perfil/cache de usuário do Teams é excluído.

Desabilitar o novo update automático do Teams

Para impedir que o novo Teams seja atualizado automaticamente, use a seguinte chave de registro na máquina virtual. Somente novos builds do Teams superiores a 23306.3314.2555.9628 na VDI podem processar essa chave de registro.

Location: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams
Name: disableAutoUpdate
Type: DWORD
Value: 1

Localização de perfil e cache para novo cliente do Teams

Todas as configurações e configurações do usuário agora estão armazenadas em:

  • Nome de usuário> C:\Usuários<\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\
  • Nome de usuário> C:\Usuários<\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\Settings\settings.dat
  • Nome de usuário> C:\Usuários<\AppData\Local\Publishers\8wekyb3d8bbwe\TeamsSharedConfig\app_switcher_settings.json
  • Nome de usuário> C:\Usuários<\AppData\Local\Publishers\8wekyb3d8bbwe\TeamsSharedConfig\tma_settings.json

Verifique se essas pastas e arquivos são persistentes para o funcionamento adequado do Teams.

Nota

É fundamental que todos os diretórios necessários e a estrutura de pastas superiores em AppData\Local\Packages\MSTeams_8wekyb3d8bbwe sejam configurados corretamente como diretórios, não como arquivos ou pontos de reparse e percorram o perfil do usuário:

AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\AC AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\AppData AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalState AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\RoamingState AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\Settings AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\SystemAppData\Local\Packages\MSTeams_8wekyb3d8bbwe\TempState

O TeamsSharedConfig armazena configurações de usuário para o alternância do alternador de aplicativos do Teams (e o que deve ser o aplicativo padrão, o Clássico ou Novo Teams) e a Reunião do Teams Adicionar para Outlook.

A pasta "meeting-addin" em TeamsSharedConfig não deve ser persistente, pois isso pode causar problemas com as coordenadas de reunião padrão nos modelos de reunião inseridos no Outlook.

Importante

Os clientes que usam o FSLogix precisam instalar o hotfix 2.9.8784.63912 para garantir a integração adequada com o novo cliente do Teams na VDI. O hotfix aborda os seguintes problemas:

  • Em ambientes multiusuários não persistentes, o novo Teams pode ficar sem registro para alguns usuários após uma nova atualização do Teams
  • Durante a saída do usuário, novos dados/cache do usuário cliente do Teams localizados em %LocalAppData%\Packages\MSTeams_8wekyb3d8bbwe\LocalCache não foram salvos nos contêineres FSLogix Profile ou ODFC.

Nota: Os clientes que usam o Perfil e o ODFC ou apenas contêineres ODFC, ainda precisarão adicionar a configuração 'IncludeTeams' para que os novos dados/cache de usuário do Teams sejam preservados.

Nota

Não há suporte para redirecionamento de pastas ou perfis de usuário móveis com o novo cliente do Teams em ambientes VDI, pois eles não podem percorrer pastas no AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams. Os clientes podem continuar a usar o Redirecionamento de Pastas ou Perfis de Usuário Roaming com um produto complementar, como FSLogix, Citrix Profile Manager, VMware e DEM, que podem percorrer as pastas Appdata\Local acima.

Exclusões de pastas

Uso do armazenamento em disco

O novo aplicativo teams ocupa cerca de 50% menos espaço em disco do que a versão clássica. Para facilitar a distribuição do nosso cliente para dispositivos Windows, adicionamos suporte ao MSIX, o que melhora a confiabilidade das instalações e das atualizações de aplicativo, bem como reduz a largura de banda de rede e o consumo de espaço em disco. Essa tecnologia de empacotamento também mostra o uso preciso do espaço em disco. Os usuários podem ver um uso de disco maior do que o Teams clássico nas configurações do Windows, mas a diferença é principalmente porque o espaço em disco relacionado ao Teams clássico baseado em elétrons não é totalmente e corretamente mostrado.

Pegada de disco – Pastas de chave e localização

  • Instalador de aplicativos: C:\Program Files\WindowsApps\MSTeams_[version]_[arch]__8wekyb3d8bbwe Inclui o pacote de instalação, dá suporte à capacidade de redefinir o aplicativo e permite instancamento único.
  • Dados do usuário e do aplicativo: C:\Users alias<>\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe Isso inclui código (pacotes Javascript), cache de código, cache de navegador, bancos de dados para dados de usuário (como conversas que se dimensionam com base no uso) e armazenamento web (de domínios hospedados no Teams, como Sharepoint, Viva aprendizado, Aplicativos e assim por diante).

A estrutura de pasta subjacente é logicamente semelhante ao Teams clássico baseado em elétrons. Para configurações não persistentes em que o volume de armazenamento é uma consideração, as seguintes diretrizes se aplicam:

Pasta Caminho da pasta Função Impacto da exclusão
Logs LocalCache\Microsoft\MSTeams\Logs
LocalCache\Microsoft\MSTeams\PerfLog		 Diagnóstico, logs de perf e assim por diante. Sem impacto.
WebStorage LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ WebStorage Armazenamento usado e gerenciado pelo navegador ao acessar outros aplicativos Web dentro de um aplicativo Web usando iframes. Por exemplo, carregar aplicativos do Sharepoint, OneDrive e office no Teams. Carregar esses aplicativos novamente pode ser mais lento depois de limpar esse cache.
GPU Cache LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ GPUCache Cache de GPU. Sem impacto.
Examine as considerações de compensação, exigindo avaliação e teste para esses ambientes
Pasta Caminho da pasta Função Impacto da exclusão
Trabalhador de serviço LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ Service Worker\CacheStorage
LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\Code Cache		 Código e cache de Scripts Web/JS para o aplicativo a ser executado. – Desempenho reduzido para baixar e carregar scripts em cada lançamento
de aplicativo – Sem acesso offline ao aplicativo
IndexedDB LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\IndexedDB Contém dados do aplicativo e do usuário e é a maneira recomendada de armazenar dados em cache em escala em um aplicativo Web para melhorar a capacidade de resposta. - Tempos de inicialização de aplicativos significativamente maiores, como dados (como conversas de chat ou canal) devem ser reduzidos, juntamente com o uso da rede como dados que precisam ser baixados e armazenados em cache todas as vezes.
- O tamanho dos dados varia de acordo com o perfil do usuário.
- Os usuários podem ver Que estamos configurando as coisas para você na tela de lançamento.
Cache LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\Cache Cache usado e gerenciado pelo navegador para o conteúdo de todas as chamadas de rede que saem do aplicativo. Também conhecido como Cache de Disco. Por exemplo, as imagens de perfil no Teams são armazenadas principalmente em cache neste armazenamento pelo navegador. Eles precisarão ser baixados novamente.

Além das pastas nesta seção, não recomendamos excluir diretórios adicionais.

Nova integração do Teams e do Outlook

Quando a caixa de seleção "Registrar o novo Teams como o aplicativo de chat do Microsoft 365" é selecionada em Configurações > Sistema Geral > , isso permite que o novo cliente do Teams se integre a todos os aplicativos do Microsoft 365 que têm recursos de mensagem instantânea (presença, chat, VOIP etc.).

Por exemplo, o Outlook passa pelo processo de descoberta descrito aqui para integrar-se ao aplicativo cliente de IM padrão: Integrando aplicativos de IM ao Office

Nota

Se o novo Teams estiver instalado em uma máquina virtual em que o Teams clássico não está instalado, você deve ter certeza de que está usando a nova versão do Teams 23320.3021.2567.4799 ou superior para garantir a integração adequada com o Outlook e a presença.

Suplemento da Reunião do Teams

Além disso, o novo pacote MSIX do Teams empacota o MSI do suplemento da Reunião do Teams (ou TMA) ("MicrosoftTeamsMeetingAddinInstaller.msi"). O TMA permite agendar uma reunião do Teams do Outlook.

Para artigos de segurança relacionados à integração do TMA com o cliente do Outlook, saiba mais em Segurança de suplemento de reunião do Teams ao usar seu cliente do Outlook.

Todos os novos arquivos do Teams instalados no computador são assinados, para que os administradores de TI possam usar as políticas AppLocker/Code Integrity/Windows Defender Application Guard configuradas para impor isso.

  • Para novas instalações do TMA por usuário do Teams, a pasta de instalação está em AppData\Local\Microsoft\TeamsMeetingAddin
  • A partir da nova versão do Teams 24060.2623.2790.8046, a pasta de instalação TMA por usuário é alterada para AppData\Local\Microsoft\TeamsMeetingAdd-in (um '-'' adicional)
  • Os logs de instalação do MSI do TMA são armazenados aqui: AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs \tma_addin_msi.txt

Nota

No Windows Server ou em ambientes multiusuários Windows 10/11, a instalação de MicrosoftTeamsMeetingAddinInstaller.msi pode falhar com o erro "Sucesso da instalação ou erro status: 1625".

Esse erro é causado por GPOs que afetam o Windows Installer. Isso inclui políticas DisableUserInstalls, DisableMSI ou AppLocker com base nas condições de regra do Publisher ou em uma RuleCollection para instalações msi. Nesse caso, você deve criar uma exceção como:

  • Caminho FilePathCondition="%PROGRAMFILES%\WINDOWSAPPS*\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI"

Solução alternativa: Você pode instalar o MSI localizado no novo diretório de instalação do Teams a partir de um prompt do Comando Administração usando:


msiexec.exe /i "C:\Program Files\WindowsApps\MSTeams_X.X.X.X_x64__8wekyb3d8bbwe\MicrosoftTeamsMeetingAddinInstaller.msi" ALLUSERS=1 /qn /norestart TARGETDIR="C:\Program Files (x86)\Microsoft\TeamsMeetingAdd-in\<version>\"

  • TargetDIR deve ser mantido consistente entre instalações para que o MSI de Suplemento de Reunião do Teams possa detectar e limpo versões mais antigas facilmente. Se vários diretórios forem usados, a instalação poderá não se comportar conforme o esperado.

  • X.X.X.X precisa ser substituído pela versão do New Teams. Verifique se há um sublinhado duplo entre a arquitetura da CPU (x64) e o PublisherID (8wekyb3d8bbwe). O número exato da versão pode ser extraído executando este comando no PowerShell:

    
Get-AppXPackage -Name "*msteams*" | Select-Object -ExpandProperty Version

  • A versão deve ser substituída pela versão do arquivo MSI, por exemplo, 1.24.2203.0. O número exato da versão pode ser extraído executando este comando no PowerShell:


PS C:\WINDOWS\system32> Get-AppLockerFileInformation -Path "C:\PROGRAM FILES\WINDOWSAPPS\MSTEAMS_24026.1000.2656.1710_X64__8WEKYB3D8BBWE\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI" | Select -ExpandProperty Publisher | select BinaryVersion

BinaryVersion

1.24.2203.0

Exemplo: Veja a seguir exemplos do comando final:


msiexec.exe /i "C:\Program Files\WindowsApps\MSTeams_23320.3021.2567.4799_x64__8wekyb3d8bbwe\MicrosoftTeamsMeetingAddinInstaller.msi" ALLUSERS=1 /qn /norestart TARGETDIR="C:\Program Files (x86)\Microsoft\TeamsMeetingAdd-in\1.24.2203.0\"

If (-not ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] 'Administrator') ){
    Write-Error "Need to run as administrator. Exiting.."
    exit 1
}

# Get Version of currently installed new Teams Package
if (-not ($NewTeamsPackageVersion = (Get-AppxPackage -Name MSTeams).Version)) {
    Write-Host "New Teams Package not found. Please install new Teams from https://aka.ms/GetTeams ."
    exit 1
}
Write-Host "Found new Teams Version: $NewTeamsPackageVersion"

# Get Teams Meeting Addin Version
$TMAPath = "{0}\WINDOWSAPPS\MSTEAMS_{1}_X64__8WEKYB3D8BBWE\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI" -f $env:programfiles,$NewTeamsPackageVersion
if (-not ($TMAVersion = (Get-AppLockerFileInformation -Path $TMAPath | Select-Object -ExpandProperty Publisher).BinaryVersion))
{
    Write-Host "Teams Meeting Addin not found in $TMAPath."
    exit 1
}
Write-Host "Found Teams Meeting Addin Version: $TMAVersion"

# Install parameters
$TargetDir = "{0}\Microsoft\TeamsMeetingAddin\{1}\" -f ${env:ProgramFiles(x86)},$TMAVersion
$params = '/i "{0}" TARGETDIR="{1}" /qn ALLUSERS=1' -f $TMAPath, $TargetDir

# Start the install process
write-host "executing msiexec.exe $params"
Start-Process msiexec.exe -ArgumentList $params
write-host "Please confirm install result in Windows Eventlog"

Após a instalação, reinicie o Outlook e verifique se o TMA está sendo carregado. Os logs estão localizados em %localappdata%\Temp\Microsoft\Teams\meeting-addin.

Para os artigos de solução de problemas de complemento da Reunião do Teams, saiba mais em: Resolver problemas com o suplemento reunião do Teams para Outlook.

Se o Teams clássico for removido e apenas novos Teams estiverem sendo instalados, o MSI de Suplemento de Reunião do Teams poderá falhar ao criar três chaves de registro em HKCU que impedem o carregamento adequado do Suplemento de Reunião.

Essas chaves devem ser implantadas por meio de scripts de entrada adicionais ou métodos semelhantes:

novo suplemento de reunião do Teams

Nota

Essas chaves de regkey HKCU não serão mais necessárias se você estiver instalando novas chaves de regkey do Teams 24060.2623.2790.8046 ou superior, pois ela empacota TeamsMeetingAddIn.msi versão 1.0.24054.1, que tem uma correção para criação bem-sucedida de chaves regkeys no HKCU.

Solução de problemas da nova integração do Teams e do Outlook

Sintomas

Você vê qualquer um dos seguintes problemas ao marcar o status de presença de um usuário no Outlook:

  • O indicador de presença não está visível.
  • A presença exibida está incorreta.
  • O status de presença é Status desconhecido.

Etapas de solução de problemas

  1. Verifique se o novo Teams está em execução. Em seguida, inicie o Outlook.
  2. Verifique as configurações do registro em seu computador para verificar se o novo Teams está registrado como o aplicativo padrão de mensagens instantâneas (IM).

a. Iniciar Editor do Registro. b. Localize a seguinte subchave:

- HKEY_CURRENT_USER\Software\IM Providers

c. Verifique os seguintes valores:

- **Name:** DefaultIMApp
- **Type:** REG_SZ
- **Data:** MsTeams (If you see Teams, it means classic Teams is still the default IM app)
  1. Localize a seguinte subchave:
  • HKEY_CURRENT_USER\Software\IM Providers\MsTeams (o Outlook monitora essa chave do registro para alterações de valor)
  1. Verifique os seguintes valores:

-Name: UpAndRunning -Type: REG_DWORD -Data: 2 (0— Não em execução, 1— Começando, 2— Em execução)

  1. Se os problemas persistirem, entre em contato com Suporte da Microsoft.

Modo de fallback de controle no Teams

Quando os usuários se conectam de um ponto de extremidade sem suporte, os usuários estão no modo fallback, no qual o Áudio/Vídeo não é otimizado. Você pode desabilitar ou habilitar o modo de fallback definindo um dos seguintes valores DWORD do registro:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams\DisableFallback HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Teams\DisableFallback

  • Para desabilitar o modo de fallback, defina o valor como 1.
  • Para habilitar somente áudio, defina o valor como 2.
  • Se o valor não estiver presente ou estiver definido como 0 (zero), o modo de fallback estará habilitado.
  • No Fallback, há suporte para a funcionalidade de compartilhamento de tela com uma interface do usuário de seletor de tela diferente (semelhante à experiência que um usuário veria no Teams for Web).

Multilocatário e multilocatário no VDI

A nova versão do Teams no VDI permite que você entre com rapidez e facilidade, permitindo que você alterne entre várias contas e organizações do mesmo ambiente de nuvem do Microsoft 365.

Nota

Não há suporte para convidados entre nuvem e reuniões na nuvem cruzada na VDI. Consulte Colaborar com convidados de outros ambientes de nuvem do Microsoft 365 e Gerenciar contas e organizações no Microsoft Teams para obter mais informações.

Se alguma de suas contas tiver acesso de convidado a outras organizações, você não precisará adicioná-las — elas serão exibidas automaticamente. Um convidado é alguém de fora de uma organização que um proprietário da equipe convida para ingressar na equipe, como um parceiro ou consultor. Os convidados têm menos recursos do que membros da equipe ou proprietários da equipe.

Saiba mais: Gerenciar contas e organizações no Microsoft Teams

Recursos atualmente não disponíveis e problemas conhecidos na VDI com o novo Teams

  • Compartilhamento de tela do chat para Áreas de Trabalho Virtuais do Azure/Windows 365 (esse problema agora está corrigido no RD Client 1.2.5105 e no Serviço de Redirecionamento 1.50.2402.29001).
  • Compartilhamento de tela do chat para Citrix ao usar somente o aplicativo Workspace 2311.
  • O alternância do alternador de aplicativo não será mostrado no novo Teams se a máquina virtual tiver o Teams clássico em toda a máquina instalado (MSI com ALLUSERS=1). Nota: Esse problema é corrigido na nova versão do Teams 23320.3021.2567.4799 ou superior.
  • msteams_autostart.exe "O parâmetro está incorreto": em ambientes não persistentes que usam contêineres de perfil FSLogix (qualquer versão) ou Citrix Profile Manager, quando o novo Teams tenta iniciar automaticamente ou um usuário tenta iniciar o Teams no menu Iniciar, ele gera o erro: "O parâmetro está incorreto". A frequência e a reprodutibilidade do erro variam dependendo do ambiente e especialmente do software antivírus que está sendo usado (SentinelOne, Palo Alto, Trend Micro, Bitdefender, CrowdStrike e assim por diante.) e exclusões em vigor.
  • O Novo Teams não é iniciado para usuários fazendo logon em áreas de trabalho virtuais não persistentes ou o aplicativo não está visível no Menu Iniciar.
    • Os administradores não enfrentam esse problema - depois de instalar o novo Teams na imagem dourada, eles podem iniciá-lo com êxito.
    • Depois de selar a imagem dourada e implantá-la em escala (com ferramentas de provisionamento como Citrix MCS/PVS ou VMware Instant-Clones), os usuários fazem logon nas máquinas virtuais e clicam no novo ícone do Teams, mas não conseguem iniciar o aplicativo. O problema é causado por um registro com falha no registro do pacote MSIX no nível do usuário com softwares de gerenciamento de perfil diferentes (FSLogix, Citrix CPM, Ivanti UEM e assim por diante), mesmo que o preparo do pacote tenha sido bem-sucedido (o sistema operacional armazenou o conteúdo do pacote no disco no diretório %ProgramFiles%\WindowsApps). Esse problema pode ser confirmado executando Get-AppxPackage -name MsTeams para os usuários afetados. Executar esse código retornará uma saída vazia.
    • Se Get-AppxPackage -name MsTeams -allusers agora for executado a partir de uma janela de comando do powershell elevada, a saída mostrará que o Teams está registrado (consulte PackageFullName de linha) e o Status está OK.

Nota

A Microsoft está trabalhando em uma solução e planeja remover essas limitações em breve.

Aprimoramentos no novo Teams

Os problemas do Teams clássico agora são corrigidos no novo Teams:

  • Multilocatário multilocatário.
  • Melhorias de desempenho nos consumos de recursos de hardware.
  • Canais 2.0.
  • As várias janelas são habilitadas por padrão, sem solicitar uma reinicialização.
  • Aprimoramentos da barra de ferramentas de compartilhamento (incluindo fixação/desafinação).

Comparação de recursos do VDI entre o Teams clássico e o novo Teams

Todos os recursos multimídia que funcionam no cliente clássico do Teams devem funcionar no novo cliente do Teams. Para matriz de recursos específica, marcar seu site do Provedor de VDI.

Provedor Detalhes
Áreas de Trabalho Virtuais do Azure e Windows 365 Recursos com suporte para o Microsoft Teams na Área de Trabalho Virtual do Azure
Citrix Otimização para o Microsoft Teams
Vmware MS Teams Optimization Feature Compatibility Matrix for Horizon 7 and Horizon 8 Recent Releases. (86475) (vmware.com)

Novos Teams para Web no VDI

Não há suporte para novas Equipes para Web em ambientes de VDI, portanto, o desempenho e a confiabilidade podem ser afetados negativamente se usados no VDI.

Recursos não compatíveis no VDI

Os recursos a seguir não têm suporte no Teams clássico ou no novo Teams.

  • Qos.
  • 1080p.
  • Planos de fundo personalizados carregados pelos usuários.
  • Teams Premium recursos (Criptografia de Ponta a Ponta, Marca D'água, Eventos Premium não são otimizados, planos de fundo de reunião personalizados para organizações).
  • Avatares.
  • Exibição da Galeria 3x3 e 7x7.
  • Supressão de ruído (exceto para AVD/W365, em que a supressão de ruído está ativada por padrão, mas a confirmação não é mostrada na interface do usuário do cliente do Teams. Isso é por design).
  • Zoom In/Out.
  • Roteamento baseado em localização.
  • Bypass de mídia.
  • HID (somente Citrix).
  • Compartilhar Áudio do Sistema (Citrix e VMware).
  • Funções de produtor e apresentador de eventos ao vivo e transmissão.
  • Junção anônima entre nuvens no Government Clouds (GCC, GCC High e DoD).
  • O clipe de vídeo de gravação não captura o compartilhamento de tela.
  • O monitor de chamada (a pequena janela flutuante depois de minimizar a janela main Teams) não exibe vídeo ou compartilhamento de tela.
  • As chamadas do Teams serão suspensas em uma máquina local se um usuário iniciar uma área de trabalho virtual dessa máquina local e fizer logon no Teams (somente AVD/W365 e VMware).