Microsoft Teams에 대한 새로운 Slimcore 기반 최적화 문제를 해결할 때 사용자가 레거시 WebRTC 스택으로 최적화되었는지 알아야 합니다. 대체 모드 "SlimCore 미디어 연결되지 않음"(또는 서버 쪽 렌더링)으로 끝날 수도 있습니다.
SlimCore로 최적화되지 않고 대신 다음이 표시됩니다
. "Azure Virtual Desktop Media Optimized"
"Citrix HDX Optimized"- 오류 코드 2000("플러그 인 없음") 및 2001("가상 채널을 사용할 수 없음")이 가장 가능성이 높은 원인입니다.
- MSTEAMS, MSTEAM1, MSTEAM2 허용하도록 '가상 채널 허용 목록'이 제대로 구성되어 있는지 확인합니다.
- 엔드포인트에 플러그 인이 있고 프로세스 Explorer VDI 클라이언트가 로드되는지 확인합니다.
- 프로세스 탐색기를 실행합니다.
- 아래쪽 창을 사용하도록 설정하고 DLL 탭으로 전환합니다.
- Azure Virtual Desktop에서 msrdc.exe 프로세스를 찾고 MsTeamsPluginAvd.dll 로드되었는지 확인합니다.
- Citrix에서 wfica32.exe 프로세스를 찾고 MsTeamsPluginCitrix.dll 로드되었는지 확인합니다.
- 새 Teams 앱을 다시 시작합니다. 플러그 인이 처음으로 검색되면 WebRTC에서 SlimCore로 전환하려면 두 번의 다시 시작이 필요합니다.
- 문제가 지속되면 Microsoft Teams VDI 관련 오류(새 Teams 24123.X.X.X 이상)에 대한 VM(가상 머신)에 검사 이벤트 뷰어.
SlimCore로 최적화되지 않고 대신 "Azure Virtual Desktop SlimCore 미디어가 연결되지 않음" 또는 "Citrix SlimCore 미디어가 연결되지 않음"이 표시됩니다.
- SlimCoreVdi MSIX 배포 오류 문제 해결 섹션을 확인합니다. MSIX 또는 AppX 관련 오류는 이 오류의 가장 가능성이 높은 이유입니다.
VDI에 대한 새 Teams 로그
VM에서 Teams를 실행하는 동안 Ctrl+Alt+Shift+1을 선택하여 Teams 로그를 수집할 수 있습니다. 이 작업은 다운로드 폴더에 ZIP 폴더를 생성합니다. PROD-WebLogs-*.zip 파일 내에서 Core 폴더를 찾습니다.
VDI 관련 정보에 대한 Vdi_debug.txt(기본 파일)
| 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 작업 영역", "pluginVersion": "2024.15.01.3", "screenShareFallback": true} |
-
vdiConnectedState 는 현재 활성 호출 스택을 표시합니다.
- connectedStack: 원격 은 Teams가 가상 채널을 통해 원격 엔드포인트에 성공적으로 연결되었음을 나타냅니다. 호출 스택이 성공적으로 초기화되었음을 의미하지는 않으므로 사용자가 통화를 시작할 수 없는 등 통화 관련 오류가 계속 발생할 수 있습니다.
- connectedStack: 로컬 은 가상 채널 연결이 실패했음을 나타냅니다. 이제 사용자가 대체 모드에 있습니다.
-
vdiVersionInfo 는 Teams 클라이언트 및 엔드포인트에 유용한 정보를 제공합니다.
- bridgeVersion 은 VM에서 실행되는 Teams 데스크톱 클라이언트의 버전에 연결됩니다.
- remoteSlimcroreVersion 은 엔드포인트에서 사용할 수 있는 SlimCore VDI의 버전입니다.
- nodeId 는 엔드포인트에 연결된 고유 ID입니다.
- clientOsVersion 은 엔드포인트의 OS 버전입니다.
- rdClientVersion 은 VM에 연결하는 데 사용되는 엔드포인트에서 실행되는 원격 데스크톱 클라이언트의 버전입니다.
- rdClientProductName 은 엔드포인트에서 실행되는 원격 데스크톱 클라이언트의 이름입니다.
- pluginVersion 은 원격 데스크톱 클라이언트에 통합된 플러그 인의 버전입니다.
Diagnostics-logs.txt weblogs\user(..)에 있을 수 있습니다.
VDI 연결 관련 문제를 추가로 조사하기 위해 vdiBRidgeEventsHandler를 키워드(keyword) 사용하여 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의 Content Delivery Network에서 SlimCore MSIX 패키지를 다운로드하려고 할 때 발생하는 오류입니다. 그런 다음, 플러그 인은 AppX용 앱 준비 서비스를 사용하여 패키지를 엔드포인트에 스테이징하거나 프로비전하려고 시도합니다. 부하 오류는 플러그 인이 MsTeamsVdi.exe 시작하고 RPC(원격 프로시저 호출)를 설정하려고 할 때 발생하는 오류입니다.
여기에 기록된 코드는 다음 표를 사용하여 매핑해야 합니다.
| loadErrc | deployErrc | 정의 | 참고 |
|---|---|---|---|
| 0 | 0 | 그래 | 오류가 아닙니다. 'SlimCore 연결' 성공 |
| 5 | 43 | ERROR_ACCESS_DENIED | 시작 시 MsTeamsVdi.exe 프로세스가 실패했습니다. BlockNonAdminUserInstall을 사용하도록 설정하면 이 오류가 발생할 수 있습니다. 또는 엔드포인트가 사용자 로그온 후 여러 MSIX 패키지를 등록하는 데 사용 중일 수 있으며 SlimCoreVdi 등록을 완료하지 못했습니다. |
| 404 | 3235 | HTTP_STATUS_NOT_FOUND | 게시 문제: 콘텐츠 배달 네트워크에서 SlimCore MSIX 패키지를 찾을 수 없습니다. |
| 1260 | 10083 | ERROR_ACCESS_DISABLED_BY_POLICY | 이 오류는 일반적으로 Windows 패키지 관리자 SlimCore MSIX 패키지를 설치할 수 없음을 의미합니다. 이벤트 뷰어 16진수 오류 코드 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이 없거나 엔드포인트가 있는 경우 로드되지 않았습니다(프로세스 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 | 플러그 인이 응답하지 않습니다. | RDP(원격 데스크톱 프로토콜) 또는 ICA(독립 컴퓨팅 아키텍처) 세션을 다시 시작해 보세요. |
| 3005 | 24043 | 다운로드하는 동안 플러그 인 제한 시간 | 2분 이내에 MSIX를 다운로드하지 못했습니다. |
| 3007 | 24058 | 로드 시간 제한 | SlimCore 다운로드 또는 설치 시간이 초과되었습니다(느린 인터넷 또는 앱 준비 서비스가 사용 중임). |
| 4000 | ERROR_WINS_INTERNAL | WINS에서 명령을 처리하는 동안 오류가 발생했습니다. | |
| 15615 | 1951 | ERROR_INSTALL_POLICY_FAILURE | SlimCore MSIX 관련 오류입니다. 이 앱을 설치하려면 Windows 개발자 라이선스 또는 사이드로드 사용 시스템이 필요합니다. AllowAllTrustedApps regkey를 0으로 설정할 수 있나요? |
| 15616 | ERROR_PACKAGE_UPDATING | SlimCore MSIX 관련 오류 '애플리케이션이 현재 업데이트 중이므로 시작할 수 없습니다.' | |
| 15700 | APPMODEL_ERROR_NO_PACKAGE | 프로세스에 패키지 ID가 없습니다. %LOCALAPPDATA%\Microsoft\WindowsApps에는 MsTeamsVdi에 대한 별칭이 없습니다. 오류를 재현하는 동안 피드백 허브 로그가 필요합니다(범주로 개발자 플랫폼을 선택하고 앱 배포를 하위 범주로 선택해야 합니다). | |
| 16389 | 패키지 관리자가 보고한 E_FAIL | 일반적으로 로드 오류 코드 5(ERROR_ACCESS_DENIED)와 동일합니다. 사용자가 관리 아닌 경우 BlockNonAdminUserInstall 정책으로 인해 발생할 가능성이 높습니다. 자세한 내용은 이 링크를 확인하세요. |
문제 해결을 위해 VM에서 이벤트 뷰어 사용
모든 연결/연결 끊기 이벤트는 Virtual Machine에서 실행되는 이벤트 뷰어 기록됩니다. 이벤트 뷰어 클라이언트 쪽 관련 오류를 표시할 수도 있습니다. Windows Logs\Application에서 원본(Microsoft Teams VDI) 및 이벤트 ID(0)를 기준으로 필터링합니다. 오류 코드는 VDI에 대한 새 Teams 로그 섹션에서 찾을 수 있습니다.
참고
원본을 기준으로 필터링하려면 관리자 권한 PowerShell 창에서 다음 명령을 실행해야 합니다.
PS C:\Windows\system32> New-EventLog -LogName 애플리케이션 -원본 "Microsoft Teams VDI"
플러그 인 배포 오류 문제 해결
진단 정보는 사용자 디바이스의 자세한 이벤트 로그에서 찾을 수 있습니다. 설치 후 MsTeamsPluginCitrix.dll CWA(Citrix 작업 영역 앱) 폴더에 기록됩니다. Citrix 플랫폼에 대해서만 엔드포인트(VM 아님)에서 다음 키가 만들어집니다.
| 키 | 키 유형 | 키 이름 | 키 값 |
|---|---|---|---|
| HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0 | 문자열 | VirtualDriverEx | MicrosoftTeamsVDI |
| HKLM\SOFTWARE\WOW6432Node\Citrix\ICAClient\Engine\Configuration\Advanced\Modules\MicrosoftTeamsVDI | 문자열 | DriverNameWin32 | MsTeamsPluginCitrix.dll |
설치를 디버그하려면 설치 관리자 로깅을 사용하도록 설정할 수 있지만 msiexec을 수동으로 사용하고 올바른 플래그를 전달해야 합니다. 예를 들어 플러그 인이 현재 설치되어 있지 않으면 msiexec.exe /i MsTeamsPluginCitrix.msi /l*vx installer.log.txt 같은 로그와 함께 설치할 수 있습니다.
SlimCoreVdi MSIX 배포 오류 문제 해결
특정 GPO(그룹 정책)가 MSIX 설치를 방지할 수 있으므로 엔드포인트 섹션에서 SlimCore MSIX 스테이징 및 등록 을 검토해야 합니다.
진단 정보는 사용자 디바이스의 자세한 이벤트 로그에서 찾을 수 있습니다.
이벤트 뷰어(로컬) > 애플리케이션 및 서비스 로그 Microsoft > Windows로 > 이동합니다.
다음 범주에서 사용 가능한 로그를 확인합니다.
- AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
- > Microsoft-Windows-AppXDeploymentServer/Operational AppXDeployment-Server
AppXDeployment-Server에서 로그를 검토합니다.
오류 15615
오류 15615는 일반적으로 Windows 패키지 관리자 SlimCoreVdi를 사용하여 MSIX 패키지를 설치할 수 없음을 의미합니다.
- 엔드포인트가 해당 MSIX의 디지털 서명을 신뢰하는지 확인합니다(MSIX > 속성 > 디지털 서명 > 세부 정보로 이동). 유효한 스토어 친화적인 Microsoft 서명이지만 고객에게는 특별한 구성이 있을 수 있습니다.
- AllowAllTrustedApps 정책을 사용하도록 설정해 보세요.
- 신뢰할 수 있는 비스토어 원본에서 앱을 테스트용으로 로드하도록 허용합니다.
- Windows 10 이 설정은 기본적으로 사용하도록 설정되므로 사용하지 않도록 설정된 경우 여기에서 수정합니다. 개발자를 위한 설정 > 업데이트 및 보안 > 앱을 테스트용으로 로드합니다>.
- Windows 11 설정은 기본적으로 사용하도록 설정됩니다. 설정 > 앱 > 고급 앱 설정 > 어디서나 앱을 > 가져올 위치 선택.
로그 컬렉션
로깅은 다음 위치에서 찾을 수 있습니다.
- 클라이언트에서:
AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylibAppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
- 서버에서:
AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\skylib