在排查 Microsoft Teams 的新 Slimcore 優化時，你需要知道使用者是否已經用舊有的 WebRTC 堆疊進行優化。 它們也可能進入備援模式「SlimCore Media Not Connected」 (或伺服器端渲染) 。
沒有用 SlimCore 優化，而是你會看到：「
Azure 虛擬桌面媒體優化」「
Citrix HDX 優化」- 錯誤代碼 2000 (「無插件」) 及 2001 (「虛擬頻道無法使用」) 是最可能的原因。
- 確保你的「虛擬頻道允許清單」正確設定，允許 MSTEAMS、MSTEAM1、MSTEAM2。
- 確保端點有該插件，並且 VDI 用戶端搭配程序總管載入它：
- 執行 程序瀏覽器。
- 啟用底部窗格並切換到 DLL 標籤。
- 在Azure虛擬桌面上，尋找 msrdc.exe 程序，並確保 MsTeamsPluginAvd.dll 已載入。
- 在 Citrix 上，找 wfica32.exe 流程，確保 MsTeamsPluginCitrix.dll 已載入。
- 重新啟動 Teams 應用程式。 當首次偵測到外掛時，需要重啟兩次才能從 WebRTC 轉換到 SlimCore。
- 如果問題依舊，請檢查虛擬機 (虛擬機) 事件檢視器Microsoft，檢查 Teams 24123.X.X.X 或更高) (Teams VDI 相關的錯誤。
沒有用 SlimCore 優化，反而你會看到：「Azure Virtual Desktop SlimCore 媒體未連接」或「Citrix SlimCore 媒體未連接」。
- 請查看 SlimCoreVdi MSIX 部署錯誤 故障排除章節。 MSIX 或 AppX 相關錯誤是造成此錯誤最可能的原因。
VDI 的 Teams 日誌
Teams 日誌可透過在虛擬機上執行 Teams 時選擇 Ctrl+Alt+Shift+1 來收集。 此操作會在 Downloads 資料夾中產生一個 ZIP 資料夾。 在 PROD-WebLogs-*.zip 檔案中，尋找 Core 資料夾。
Vdi_debug.txt (VDI 相關資訊的主要檔案)
| Azure Virtual Desktop/W365 | Citrix |
|---|---|
| “vdiConnectedState”： {“connectedStack”： “remote”}， “vdiVersionInfo”： {“bridgeVersion”： “2024.18.1.11”， “remoteSlimcoreVersion”： “2024.18.01.11”， “nodeId”： “1051a908af6b160e”， “clientOsVersion”： “10.0.22631”， “rdClientVersion”： “1.2.5405.0”， “rdClientProductName”： “Microsoft® Remote Desktop”， “pluginVersion”： “2024.14.01.1”， “screenShareFallback”： true} | “vdiConnectedState”： {“connectedStack”： “remote”}， “vdiVersionInfo”： {“bridgeVersion”： “2024.18.1.14”， “remoteSlimcoreVersion”： “2024.18.01.14”， “nodeId”： “ffffffff93eaee6a”， “clientOsVersion”： “10.0.22631”， “rdClientVersion”： “24.3.0.64”， “rdClientProductName”： “Citrix Workspace”， “pluginVersion”： “2024.15.01.3”， “screenShareFallback”： true} |
-
vdiConnectedState 顯示目前的有效呼叫堆疊。
- connectedStack： remote 表示 Teams 已透過虛擬通道成功連接遠端端點。 這不一定代表呼叫堆疊已成功初始化，因此使用者仍可能遇到與呼叫相關失敗的情況，例如無法啟動呼叫。
- connectedStack： local 表示虛擬通道連線失敗。 使用者現在處於備援模式。
-
vdiVersionInfo 為 Teams 用戶端和端點提供有用的資訊。
- bridgeVersion 綁定於虛擬機上執行的 Teams 桌面用戶端版本。
- remoteSlimcroreVersion 是端點上可用的 SlimCore VDI 版本。
- nodeId 是綁定到端點的唯一 ID。
- clientOsVersion 是該端點的作業系統版本。
- rdClientVersion 是遠端桌面用戶端的版本，該用戶端用於連接虛擬機。
- rdClientProductName 是執行於端點上的遠端桌面用戶端名稱。
- pluginVersion 是整合於遠端桌面用戶端的外掛版本。
Diagnostics-logs.txt 可能在部落格/用戶 ( 上......)
為了進一步探討VDI連線相關問題，使用關鍵字 vdiBRidgeEventsHandler 提供vdiBridge連線與斷線事件處理的日誌，如下例onConnected事件處理 () 新優化堆疊成功連線所示：
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
連線錯誤
如果有連線錯誤，錯誤代碼可以從包含「loadErrc」和「deployErrc」的日誌行中找到。 部署錯誤 (也稱為 install_error) ，是外掛嘗試從 Microsoft 的內容傳遞網路下載 SlimCore MSIX 套件時發生的錯誤。 外掛接著會嘗試使用 AppX 的 App Readiness Service 將套件分階段或配置到端點。 載入錯誤是指外掛嘗試啟動 MsTeamsVdi.exe 並建立遠端程序呼叫 (RPC) 時所發生的錯誤。
這裡記錄的程式碼需要用這個表格來對應：
| loadErrc | 部署Errc | 定義 | 注釋 |
|---|---|---|---|
| 0 | 0 | 好 | 這不是錯誤。 「SlimCore Connected」成功 |
| 5 | 43 | ERROR_ACCESS_DENIED | MsTeamsVdi.exe 流程在啟動時失敗了。 啟用 BlockNonAdminUserInstall 可能會導致這個錯誤。 或者端點可能在使用者登入後忙著註冊多個 MSIX 套件，卻沒完成 SlimCoreVdi 的註冊。 |
| 404 | 3235 | HTTP_STATUS_NOT_FOUND | 發佈問題：SlimCore MSIX 套件不在 Content Delivery Network 上。 |
| 1260 | 10083 | ERROR_ACCESS_DISABLED_BY_POLICY | 此錯誤通常代表 Windows 封裝管理員無法安裝 SlimCore MSIX 套件。 事件檢視器可以顯示十六進位錯誤碼0x800704EC。 AppLocker 政策可能導致此錯誤代碼。 你可以停用 AppLocker，或在本地安全政策 -> 應用程式控制政策 -> AppLocker 中新增 SlimCoreVdi 套件的例外。 請在「使用 Teams 的新 VDI 解決方案進行優化」 中的步驟 3 查看。 |
| 1460 | 11683 | ERROR_time | MsTeamsVdi.exe 程序在啟動時失敗 (60秒的超時) 。 |
| 1722 | RPC_S_SERVER_UNAVAILABLE | 「RPC 伺服器無法使用」MsTeamsVdi.exe 相關錯誤。 | |
| 2000 | 16002 | 沒有外掛 | 端點沒有 MsTeamsPlugin，或者即使有，也沒用 Process Explorer) (檢查。 |
| 2001 | 虛擬頻道無法使用 | Citrix VDA (虛擬配送代理程式) WFAPI 發生錯誤。 | |
| 2003 | 16026 | 由於 Citrix Studio 政策，MSTEAMS、MSTEAM1 和 MSTEAM2) (自訂虛擬頻道被封鎖 | 請參閱 VDI 2.0 文章中 Citrix 虛擬通道允許清單 的章節。 |
| 2005 | 16043 | Teams 以發佈應用程式形式運行 (Citrix) 或 RemoteApp， (AVD/Windows 365) | 此模式目前不支援——Teams 不會載入 SlimCore，且使用者始終以 WebRTC 進行優化。 |
| 3000 | 24002 | 不需要 SlimCore 部署 | 這個程式碼其實不算錯誤。 這很明顯地表示使用者已經採用了 SlimCore 的新優化架構。 |
| 3001 | 24010 | SlimCore 已經載入 | 這個程式碼其實不算錯誤。 這很明顯地表示使用者已經採用了 SlimCore 的新優化架構。 |
| 3004 | 24035 | 插件反應不快 | 試著用遠端桌面協定) 或 ICA (獨立運算架構 () 會話重新啟動 RDP。 |
| 3005 | 24043 | 下載時插件逾時 | 2 分鐘內無法下載 MSIX。 |
| 3007 | 24058 | 載入超時 | SlimCore 下載或安裝 (網路慢或應用程式準備服務忙碌) 而逾時。 |
| 4000 | ERROR_WINS_INTERNAL | WINS 在處理指令時遇到錯誤。 | |
| 4390 | ERROR_NOT_A_REPARSE_POINT | SlimCore MSIX 在使用統一寫入過濾器與 RAM 磁碟覆蓋層的瘦客戶端中出現相關錯誤。 請查看 此區 | |
| 15615 | 1951 | ERROR_INSTALL_POLICY_FAILURE | SlimCore MSIX 相關錯誤。 要安裝這個應用程式，你需要 Windows 開發者授權，或是支援側載的系統。 AllowAllTrustedApps 的 regkey 可能設為 0？ |
| 15616 | ERROR_PACKAGE_UPDATING | SlimCore MSIX 相關錯誤「應用程式無法啟動，因為目前正在更新」。 | |
| 15700 | APPMODEL_ERROR_NO_PACKAGE | 這個程序沒有套件身份。 在 %LOCALAPPDATA%\Microsoft\WindowsApps 中，MsTeamsVdi 沒有別名。 在重現錯誤時需要提供回饋中心日誌 (請確保你選擇開發者平台作為類別，應用程式部署作為子類別) | |
| 16389 | E_FAIL由套件管理員回報 | 通常與載入錯誤代碼5相同 (ERROR_ACCESS_DENIED) 。 很可能是因為 BlockNonAdminUserInstall 政策，當使用者不是管理員時。請點此連結了解更多詳情。 |
在虛擬機上使用 事件檢視器進行故障排除
每個連接/斷開事件都會被記錄在虛擬機上運行的事件檢視器中。 事件檢視器也能顯示與用戶端相關的錯誤。 在 Windows 日誌\應用程式中，依來源Microsoft (篩選 Teams VDI) 和事件 ID (0) 。 錯誤代碼可在 Teams 日誌中的 VDI 區塊中找到。
備註
為了能夠依來源篩選，你需要從一個提升的 PowerShell 視窗執行以下指令：
PS C：\Windows\system32> New-EventLog -logName Application -來源「Microsoft Teams VDI」
外掛部署錯誤故障排除
診斷資訊可在使用者裝置上的詳細事件日誌中找到。 安裝後，MsTeamsPluginCitrix.dll 會寫入 CWA (Citrix Workspace 應用程式) 資料夾。 僅針對 Citrix 平台，會建立以下金鑰於端點 (非虛擬機) ：
| 機碼 | 鍵型 | 主要名稱 | 關鍵價值 |
|---|---|---|---|
| HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0 | String | VirtualDriverEx | MicrosoftTeamsVDI |
| HKLM\SOFTWARE\WOW6432Node\Citrix\ICAClient\Engine\Configuration\Advanced\Modules\MicrosoftTeamsVDI | String | 駕駛名Win32 | MsTeamsPluginCitrix.dll |
要除錯安裝，你可以啟用安裝程式日誌，但必須手動使用 msiexec，並通過正確的旗標。 例如，如果外掛目前尚未安裝，可以用日誌安裝：msiexec.exe /i MsTeamsPluginCitrix.msi /l*vx installer.log.txt。
故障排除 SlimCoreVdi MSIX 部署錯誤
請務必檢視 SlimCore MSIX 在端點的預備與註冊 部分，因為某些 GPO (群組政策) 可能阻止 MSIX 安裝。
診斷資訊可在使用者裝置上的詳細事件日誌中找到。
事件檢視器 (Windows) > Local Applications and Services logs > Microsoft > Windows。
請檢查以下類別下的可用日誌：
- AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
- AppXDeployment-Server > Microsoft-Windows-AppXDeploymentServer/Operational
請查看 AppXDeployment-Server 下的日誌。
錯誤 15615
錯誤 15615 通常表示 Windows 封裝管理員無法安裝帶有 SlimCoreVDI 的 MSIX 套件。
- 請確保端點信任該 MSIX 的數位簽章 (前往 MSIX > 屬性 > 數位簽章 > 詳情) 。 這是有效的 Microsoft 商店友善簽名，但客戶可能有特殊設定。
- 試著啟用 AllowAllTrustedApps 政策。
- 試著允許來自受信任非商店來源的應用程式側載。
- 在 Windows 10 上，這個設定預設是啟用的，如果你發現它被關閉，請在這裡修改：設定 > 更新與安全性 > 給開發者 > 側載應用程式。
- 在 Windows 11 中，此設定預設為啟用：設定>、應用程式>、進階應用程式設定>、選擇「在哪裡取得應用程式>」，任何地方。
日誌收集
伐木活動可在以下地點找到：
在客戶端 (舊版 SlimCores 在新分割架構前的 Host 和 Framework) ：
AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylibAppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
在客戶端 (針對帶有主機和框架的分割架構新 SlimCore) ：
AppData\Local\Packages\Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe\LocalCache\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylibAppData\Local\Packages\Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe\LocalCache\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
在伺服器上：
AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\skylib