Risoluzione dei problemi relativi alla nuova ottimizzazione

Durante la risoluzione dei problemi della nuova ottimizzazione basata su Slimcore per Microsoft Teams, è necessario sapere se gli utenti sono ottimizzati con il nuovo stack WebRTC legacy. Potrebbero anche finire nella modalità di fallback "SlimCore Media non connesso" (o rendering lato server).

  • Non ottimizzato con SlimCore e viene invece visualizzato:
    "Desktop virtuale Azure Media Optimized"
    "Citrix HDX Optimized"

    • Le cause più probabili sono i codici di errore 2000 ("Nessun plug-in") e 2003 ("Canale virtuale non consentito").
    1. Assicurarsi che il criterio "Elenco canali virtuali consentiti" in Citrix Studio sia configurato correttamente per consentire MSTEAMS, MSTEAM1 MSTEAM2.
    2. Assicurarsi che l'endpoint disponga del plug-in e che il client VDI con Process Explorer lo carichi:
      1. Eseguire Esplora processi.
      2. Abilitare il riquadro inferiore e passare alla scheda DLL.
      3. In Desktop virtuale Azure cercare il processo di msrdc.exe e assicurarsi che il MsTeamsPluginAvd.dll sia caricato.
      4. In Citrix cerca il processo di wfica32.exe e assicurati che il MsTeamsPluginCitrix.dll sia caricato.
    3. Riavviare l'app Teams. Richiede un riavvio per passare da WebRTC a SlimCore, quando il plug-in viene rilevato per la prima volta.
    4. Se il problema persiste, controlla il Visualizzatore eventi nella macchina virtuale (VM) per verificare la presenza di errori relativi alla VDI di Microsoft Teams (Teams 24123.X.X.X o versione successiva).
  • Non ottimizzato con SlimCore e viene invece visualizzato: "Supporto slimCore di Desktop virtuale Azure non connesso" o "Supporto slimCore Citrix non connesso".

Dashboard Integrità client di Teams

Integrità dei client di Teams all'interno dell'interfaccia di amministrazione di Teams è una pagina completamente nuova con un set di dati, approfondimenti e strumenti che consentono agli amministratori di risolvere e correggere i problemi relativi alle VDI. Nella scheda "Problemi", gli amministratori possono trovare gli errori "Errore di ottimizzazione VDI", con descrizioni e azioni correttive per gestire e correggere i problemi prima che influiscano sulla produttività degli utenti finali o causino ulteriori escalation. Questi errori sono in genere perseguibili, tramite oggetti Criteri di gruppo, impostazioni di rete, configurazioni o AppX. Sono causati da attività correlate a MSIX quando il plug-in tenta di installare/caricare/distribuire SlimCore o da configurazioni mancanti come l'elenco dei canali virtuali consentiti di Citrix o il plug-in mancante. I codici di errore sono mappati nella tabella seguente.

Suggerimento

Le informazioni esposte in TCH sono preziose per l'amministratore, sia come strumento di monitoraggio proattivo che reattivo. Microsoft consiglia di rivedere le informazioni su base giornaliera/settimanale e di creare i report automatizzati corrispondenti.

Screenshot che mostra la pagina Integrità del client Teams.

Log di Teams per VDI

I log di Teams possono essere raccolti selezionando CTRL+ALT+MAIUSC+1 durante l'esecuzione di Teams in una macchina virtuale. Questa azione produce una cartella ZIP nella cartella Download. All'interno del file PROD-WebLogs-*.zip cercare la cartella Core.

Desktop virtuale 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® Desktop remoto", "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 lo stack di chiamate attivo corrente.
    • Stackconnesso: remoto indica che Teams è riuscito a connettersi all'endpoint remoto tramite il canale virtuale. Ciò non significa necessariamente che lo stack di chiamate sia stato inizializzato correttamente, quindi l'utente può comunque riscontrare errori correlati alle chiamate, ad esempio l'impossibilità di avviare una chiamata.
    • connectedStack: local indica che la connessione al canale virtuale non è riuscita. L'utente è ora in modalità fallback.
  • vdiVersionInfo fornisce informazioni utili per il client e l'endpoint di Teams.
    • bridgeVersion è associato alla versione del client desktop di Teams in esecuzione nella macchina virtuale.
    • remoteSlimcoreVersion è la versione della VDI SlimCore disponibile sull'endpoint.
    • nodeId è un ID univoco associato all'endpoint.
    • clientOsVersion è la versione del sistema operativo per l'endpoint.
    • rdClientVersion è la versione del client desktop remoto in esecuzione nell'endpoint che viene usato per connettersi alla macchina virtuale.
    • rdClientProductName è il nome del client desktop remoto in esecuzione nell'endpoint.
    • pluginVersion è la versione del plug-in integrata nel client desktop remoto.

Diagnostics-logs.txt

Questo file si trova anche in Weblogs\user(..). Per approfondire ulteriormente i problemi relativi alla connessione VDI, utilizzando la parola chiave vdiBridgeEventsHandler fornisce i log dalle gestioni degli eventi di connessione e disconnessione di vdiBridge, come illustrato (gestione degli eventi onConnected) nell'esempio seguente di una connessione riuscita con il nuovo stack di ottimizzazione:

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

Errore di connessione

Se si verifica un errore di connessione, il codice di errore può essere trovato dalla riga di log contenente "loadErrc" e "deployErrc". Un errore di distribuzione (noto anche come install_error) è un errore che si verifica quando il plug-in stava tentando di scaricare il pacchetto SlimCore MSIX dalla rete per la distribuzione di contenuti Microsoft. Il plug-in tenta quindi di eseguire un'installazione di appoggio o di effettuare il provisioning del pacchetto nell'endpoint usando il servizio di preparazione delle app per AppX. Un errore di caricamento è un errore che si verifica quando il plug-in tenta di avviare MsTeamsVdi.exe e stabilire una chiamata di procedura remota (RPC).

Il codice registrato qui deve essere mappato usando questa tabella:

Codice di errore Standard loadErrc o deployErrc Definizione Note
0 0 OK Non è un errore. Successo 'SlimCore Connected', l'utente è correttamente ottimizzato
5 43 ERROR_ACCESS_DENIED MsTeamsVdi.exe processo non è riuscito all'avvio. L'abilitazione di BlockNonAdminUserInstall potrebbe causare questo errore. Oppure l'endpoint potrebbe essere occupato durante la registrazione di più pacchetti MSIX dopo che un accesso utente e il servizio AppX non hanno terminato la registrazione di SlimCoreVdi.
110 ERROR_OPEN_FAILED Criteri di accesso in background di Windows che bloccano i BITS ("BG_E_BLOCKED_BY_BACKGROUND_ACCESS_POLICY"), che impediscono i download di SlimCore durante l'ottimizzazione. Per gli utenti AVD/W365, l'app di app di Windows potrebbe non disporre dell'autorizzazione per l'app in background:> "Consenti l'esecuzione di questa app in background" impostata su "Sempre" in Impostazioni di Windows/App/App installate/App di app di Windows. Se questa opzione non è visibile, controlla se GlobalUserDisabled è impostato su 1 e modificalo su 0, in HKCU\Software\Microsoft\Windows\CurrentVersion\BackgroundAccessApplications
403 3227 HTTP_STATUS_FORBIDDEN Contatta i team di rete e proxy perché qualcosa blocca i download di SlimCore MSIX. Stato HTTP 403: il server è in grado di riconoscere la richiesta, ma non di soddisfarla.
404 3235 HTTP_STATUS_NOT_FOUND Problema di pubblicazione: il pacchetto SlimCore MSIX non viene trovato nella rete per la distribuzione di contenuti. Possibili interferenze da server proxy
1260 10083 ERROR_ACCESS_DISABLED_BY_POLICY Questo errore indica in genere che Gestione pacchetti Windows non è in grado di installare il pacchetto SlimCore MSIX. Visualizzatore eventi possibile visualizzare il codice di errore esadecimale 0x800704EC. I criteri AppLocker possono causare questo codice di errore. È possibile disabilitare AppLocker o aggiungere un'eccezione per i pacchetti SlimCoreVdi in Criteri di sicurezza locali -> Criteri di controllo delle applicazioni -> AppLocker. Controllare il passaggio 3 in "Ottimizzazione con la nuova soluzione VDI per Teams".
1460 11683 ERROR_time MsTeamsVdi.exe processo non è riuscito all'avvio (timeout di 60 secondi). I sintomi possono essere una lenta transizione all'ottimizzazione SlimCore, un possibile "SlimCore Media Not Connected" e un eventuale ripristino dopo l'attesa o il riavvio. Molto probabilmente la causa radice SlimCore MSIX distribuzione/registrazione è stata completata troppo lentamente.
1722 13779 RPC_S_SERVER_UNAVAILABLE "Il server RPC (Remote Procedure Call) non è disponibile". MsTeamsVdi.exe non è stato in grado di comunicare con un componente del servizio Windows da cui dipende durante l'avvio di SlimCore, molto probabilmente il servizio di preparazione delle app (ARS), le API di gestione pacchetti o le API di registrazione dei pacchetti. Se questi componenti non sono disponibili, si bloccano o si riavviano, sono previsti errori RPC. Uno scenario comune è la lentezza dei thin client con overload negli accessi utente o il ritardo delle registrazioni AppX. Anche la registrazione SlimCore danneggiata o incompleta può essere la causa. Se l'ottimizzazione ha esito positivo, considerare 1722 come una condizione transitoria piuttosto che un errore di avvio MsTeamsVdi.exe rigido. Informazioni di registrazione aggiuntive possono essere ottenute dal Visualizzatore eventi dell'endpoint (AppXDeployment-Server/Operational e AppxPackagingOM/Operational)
2000 16002 Nessun plug-in L'endpoint non ha MsTeamsPlugin o, se ce l'ha, non è stato caricato (controllare con Esplora processi).
2001 16008 Canale virtuale non disponibile Errore nell'API WFAPI (Virtual Delivery Agent) di Citrix VDA o nell'API Omnissa Agent Blast
2003 16026 I canali virtuali personalizzati (MSTEAMS, MSTEAM1 e MSTEAM2) sono bloccati a causa di un criterio di Citrix Studio Esaminare la sezione dell'elenco dei canali consentiti del canale virtuale Citrix dell'articolo VDI 2.0.
2004 16032 Versione dell'app Citrix Workspace non supportata. Aggiorna
2005 16043 Teams è in esecuzione come app pubblicata (Citrix) o RemoteApp (AVD/Windows 365) L'utente non soddisfa i requisiti minimi di versione: in questo caso Teams non carica SlimCore e gli utenti sono sempre ottimizzati con WebRTC.
2008 16066 L'app Windows per MAC in AVD/365 proviene dall'App Store, che non è supportato. È supportata solo l'app di Windows non di store.
3000 24002 Distribuzione SlimCore non necessaria Questo codice non è in realtà un errore. È un buon indicatore che l'utente è sulla nuova architettura di ottimizzazione con SlimCore.
3001 24010 SlimCore già caricato Questo codice non è in realtà un errore. È un buon indicatore che l'utente è sulla nuova architettura di ottimizzazione con SlimCore.
3002 24018 Nessun SlimCore locale SlimCore non è stato scaricato correttamente nell'endpoint.
3004 24035 Plugin irresponsive Provare a riavviare Teams. Si tratta in genere di un errore temporaneo, in cui il plug-in è impegnato a eseguire lo staging del motore multimediale. Questo errore è diverso dalla versione 2000, in cui un canale virtuale non viene stabilito. Nell'errore 3004 è stato stabilito un trasporto, ma il plug-in non ha mai risposto a Teams con un "ClientHello"
3005 24043 Timeout del plug-in durante il download Impossibile scaricare MSIX entro 2 minuti.
3007 24058 Timeout caricamento Download o installazione SlimCore timeout (internet lento o App Readiness Service è occupato).
3021 24170 Nessun pacchetto SlimCore utilizzabile Alcuni pacchetti MSIX sono presenti (in genere Framework), ma nessuna combinazione utilizzabile (in genere manca il pacchetto MSIX dell'host). Alcune impostazioni dell'utente impediscono le installazioni host.
4000 ERROR_WINS_INTERNAL WINS ha riscontrato un errore durante l'elaborazione del comando.
4390 ERROR_NOT_A_REPARSE_POINT Errore SlimCore relativo a MSIX nei thin client con filtri di scrittura unificati e sovrapposizioni di dischi RAM. Controlla questa sezione
12002 ERROR_INTERNET_TIMEOUT Problemi di connettività Internet nell'endpoint. La richiesta HTTP è scaduta. L'azione consigliata all'utente consiste nell'eseguire lo strumento NAT e rilevare i problemi nella rete per risolvere il problema
12030 ERROR_INTERNET_CONNECTION_ABORTED Problemi di connettività Internet nell'endpoint. La connessione con il server CDN Microsoft è stata terminata in modo anomalo. L'azione consigliata all'utente consiste nell'eseguire lo strumento NAT e rilevare i problemi nella rete per risolvere il problema
15615 1951 ERROR_INSTALL_POLICY_FAILURE Errore correlato a SlimCore MSIX. Per installare questa app, devi disporre di una licenza per sviluppatori Windows o di un sistema abilitato per il sideload. La chiave del registro di sistema AllowAllTrustedApps potrebbe essere impostata su 0?
15616 ERROR_PACKAGE_UPDATING Errore correlato a SlimCore MSIX. «L'applicazione non può essere avviata perché è attualmente in fase di aggiornamento». Race condition transitoria del ciclo di vita MSIX, non un errore di distribuzione hardware. Windows restituisce questo valore quando il plug-in tenta di avviare o caricare SlimCore mentre il sottosistema AppX/MSIX è ancora in fase di aggiornamento, registrazione, ripristino o sostituzione del pacchetto SlimCore nell'endpoint. Se l'ottimizzazione ha esito positivo, considerare 15616 come una condizione non irreversibile anziché un errore di distribuzione. Indaga ulteriormente solo se gli utenti rimangono in "SlimCore Media Not Connected" o non vengono mai ottimizzati con SlimCore.
15618 ERROR_PACKAGES_IN_USE Errore correlato a SlimCore MSIX. "Impossibile installare il pacchetto perché le risorse modificate sono attualmente in uso".
15700 APPMODEL_ERROR_NO_PACKAGE Il processo non ha un'identità del pacchetto. Non esiste alcun alias per MsTeamsVdi in %LOCALAPPDATA%\Microsoft\WindowsApps. I log Hub di Feedback sono necessari per riprodurre l'errore (assicurarsi di selezionare Piattaforma per sviluppatori come categoria e Distribuzione app come sottocategoria)
16389 E_FAIL segnalati da Gestione pacchetti In genere corrisponde al codice di errore di caricamento 5 (ERROR_ACCESS_DENIED). Probabilmente causato dal criterio BlockNonAdminUserInstall quando l'utente non è un Amministrazione. Controlla questo link per maggiori dettagli. Intune MDM può anche impostare questo valore. In alcune condizioni, Windows segnala l'errore 16389 (E_FAIL) come errore generico, quindi BlockNonAdminUserInstall non è l'unica causa principale. Per altre informazioni, vedere la descrizione dettagliata seguente.

Uso del Visualizzatore eventi nella macchina virtuale per la risoluzione dei problemi

Ogni evento di connessione/disconnessione viene registrato nel Visualizzatore eventi in esecuzione sulla macchina virtuale. Il Visualizzatore eventi può anche visualizzare errori correlati sul lato client. Filtrare per origine (Microsoft Teams VDI) e ID evento (0) in Registri di Windows\Applicazione. I codici di errore sono disponibili nella sezione log di Teams per VDI .

Nota

Per poter filtrare in base all'origine, è necessario eseguire questo comando da una finestra di PowerShell con privilegi elevati:

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

Risoluzione degli errori di distribuzione dei plug-in

Le informazioni diagnostiche sono disponibili nei registri eventi dettagliati nel dispositivo dell'utente. Dopo l'installazione, MsTeamsPluginCitrix.dll viene scritta nella cartella CWA (app Citrix Workspace). Solo per la piattaforma Citrix, vengono create le chiavi seguenti sull'endpoint (non sulla macchina virtuale):

Chiave Tipo di chiave Nome chiave Valore chiave
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0 Stringa VirtualDriverEx MicrosoftTeamsVDI
HKLM\SOFTWARE\WOW6432Node\Citrix\ICAClient\Engine\Configuration\Advanced\Modules\MicrosoftTeamsVDI Stringa DriverNameWin32 MsTeamsPluginCitrix.dll

Per eseguire il debug delle installazioni, è possibile abilitare la registrazione del programma di installazione, ma in seguito è necessario utilizzare msiexec manualmente e passare i flag corretti. Ad esempio, se il plugin non è attualmente installato, può essere installato con i log: msiexec.exe /i MsTeamsPluginCitrix.msi /l*vx installer.log.txt.

Risoluzione degli errori di distribuzione SlimCoreVdi MSIX

Assicurarsi di esaminare la gestione temporanea e la registrazione di SlimCore MSIX nella sezione endpoint , poiché alcuni oggetti Criteri di gruppo (criteri di gruppo) possono impedire le installazioni MSIX.

Le informazioni diagnostiche sono disponibili nei registri eventi dettagliati nel dispositivo dell'utente.

  1. Passare ai registri > applicazioni e servizi del Visualizzatore eventi (locale) > di Microsoft > Windows.

  2. Verificare la disponibilità di log in queste categorie:

    • AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
    • >AppXDeployment-Server Microsoft-Windows-AppXDeploymentServer/Operational
  3. Esamina i log in AppXDeployment-Server.

Errore 16389

L'errore 16389 (E_FAIL) è spesso un errore in cui lo stack Gestione pacchetti Windows/AppX ha riscontrato un errore sottostante, ma ha fatto emergere solo il valore E_FAIL generico. La causa più probabile è il criterio BlockNonAdminUserInstall. Questo criterio CSP per ApplicationManagement gestisce la possibilità degli utenti non amministratori di installare i pacchetti delle app di Windows, ad esempio l'host e il framework SlimCore.

Nota

Il problema può verificarsi anche quando il criterio MDM ApplicationManagement/BlockNonAdminUserInstall (Intune Catalogo impostazioni → Distribuzione pacchetti app → Blocca installazione utenti non amministratori) è impostato su 1 (Abilitato) nell'endpoint. I criteri effettivi vengono letti da: HKLM\SOFTWARE\Microsoft\PolicyManager\current\device\ApplicationManagement\BlockNonAdminUserInstall = 1 (REG_DWORD). Il server di distribuzione AppX restituisce E_ACCESSDENIED (0x80070005) al chiamante (msrdc.exe, ad esempio). Il plug-in VDI di Teams lo mostra come windows_error_16389 e interrompe la registrazione di SlimCore → la nuova ottimizzazione non viene inizializzata → la chiamata esegue un fallback a WebRTC non ottimizzato o, se disponibile.

Causa Probabilità Note
BlockNonAdminUserInstall Molto alto
AppLocker/WDAC Alta
Mancata corrispondenza della registrazione SlimCore Host/FWK Alta Risolto nel plug-in 2026.29.1.4
Problema di registrazione multiutente in modalità tutto schermo condivisa Alta Risolto nel plug-in 2026.29.1.4
Accesso alla cartella temporanea negato Medium-High

Errore 15615

L'errore 15615 indica in genere che la Gestione pacchetti Windows non può installare il pacchetto MSIX con SlimCoreVdi.

  • Assicurarsi che l'endpoint consideri attendibile la firma digitale di tale MSIX (passare a Proprietà > MSIX>: dettagli sulle firme > digitali). Si tratta di una firma Microsoft valida per lo Store, ma i clienti potrebbero avere qualcosa di speciale configurato.
  • Provare ad abilitare il criterio AllowAllTrustedApps.
  • Prova a consentire il trasferimento locale di app da origini attendibili diverse dallo store.
    • In Windows 10, questa impostazione è abilitata per impostazione predefinita, quindi modificala qui se la trovi disabilitata: Aggiornamento delle impostazioni > e sicurezza > Per gli sviluppatori > Trasferire localmente le app.
    • In Windows 11, questa impostazione è abilitata per impostazione predefinita: Impostazioni > App > Impostazioni > avanzate dell'app Scegliere dove trovare le app > ovunque.

Raccolta di log

La registrazione è disponibile nei percorsi seguenti:

  • Sul client (per i vecchi SlimCore prima della nuova architettura divisa con Host e Framework):

    • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
    • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
  • Sul client (per i nuovi SlimCore con architettura divisa con 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
  • Sul server:

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