Microsoft Teamsの新しい Slimcore ベースの最適化のトラブルシューティングを行う場合は、ユーザーが従来の WebRTC スタックで最適化されているかどうかを把握する必要があります。 また、フォールバック モード "SlimCore Media Not Connected" (またはサーバー側レンダリング) になる場合もあります。
SlimCore では最適化されておらず、代わりに表示されます:
"Azure Virtual Desktop Media Optimized"
"Citrix HDX Optimized"- エラー コード 2000 ("プラグインなし") と 2001 ("Virtual Channel not available") が最も可能性の高い原因です。
- MSTEAMS、MSTEAM1、MSTEAM2を許可するように "Virtual Channel Allow list" が適切に構成されていることを確認します。
- エンドポイントにプラグインがあることを確認し、プロセスを含む VDI クライアントエクスプローラー読み込みます。
- プロセス エクスプローラーを実行します。
- 下部のウィンドウを有効にし、[DLL] タブに切り替えます。
- Azure Virtual Desktop で、msrdc.exe プロセスを探し、MsTeamsPluginAvd.dll が読み込まれたことを確認します。
- Citrix で、wfica32.exe プロセスを探し、MsTeamsPluginCitrix.dll が読み込まれたことを確認します。
- 新しい Teams アプリを再起動します。 プラグインが初めて検出されたときに、WebRTC から SlimCore に移行するには、2 回の再起動が必要です。
- 問題が解決しない場合は、VDI 関連のエラー (新しい Teams 24123.X.X.X 以降) をMicrosoft Teamsするために仮想マシン (VM) にチェック イベント ビューアーします。
SlimCore では最適化されておらず、代わりに "Azure Virtual Desktop SlimCore Media Not Connected" または "Citrix SlimCore Media Not Connected" が表示されます。
- 「SlimCoreVdi MSIX 展開エラーのトラブルシューティング」セクションを確認してください。 MSIX または AppX 関連のエラーが、このエラーの最も可能性の高い理由です。
VDI の新しい Teams ログ
Teams ログは、VM での Teams の実行中に Ctrl + Alt + Shift + 1 を選択することで収集できます。 このアクションにより、ダウンロード フォルダーに 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": "ffffff93ee6a", "clientOsVersion": "10.0.22631", "rdClientVersion": "24.3.0.64", "rdClientProductName": "Citrix Workspace", "pluginVersion": "2024.15.01.3", "screenShareFallback": true} |
-
vdiConnectedState は、現在アクティブな呼び出し履歴を表示します。
- connectedStack: remote は、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 接続と切断イベント処理のログを提供します。
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 パッケージをダウンロードしようとしたときに発生するエラーです。 その後、プラグインは、App Readiness Service for AppX を使用して、エンドポイントにパッケージをステージングまたはプロビジョニングしようとします。 読み込みエラーは、プラグインが MsTeamsVdi.exe を開始してリモート プロシージャ コール (RPC) を確立しようとしたときに発生するエラーです。
ここでログに記録されるコードは、次の表を使用してマップする必要があります。
| loadErrc | deployErrc | 定義 | メモ |
|---|---|---|---|
| 0 | 0 | わかりました | エラーではありません。 'SlimCore Connected' の成功 |
| 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 がない場合、またはエンドポイントに MsTeamsPlugin がない場合は読み込まれません (プロセス エクスプローラーでチェック)。 |
| 2001 | 仮想チャネルが使用できない | Citrix VDA (仮想配信エージェント) WFAPI でエラーが発生しました。 | |
| 2003 | 16026 | カスタム仮想チャネル (MSTEAMS、MSTEAM1、MSTEAM2) は、Citrix Studio ポリシーによってブロックされます | 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 のダウンロードまたはインストールがタイムアウトしました (インターネットまたは App Readiness Service がビジー状態です)。 |
| 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 のエイリアスはありません。 エラーの再現中にフィードバック Hub ログが必要です (カテゴリとして [開発者プラットフォーム] を選択し、サブカテゴリとして [アプリのデプロイ] を選択してください) | |
| 16389 | パッケージ マネージャーによって報告されたE_FAIL | 通常、読み込みエラー コード 5 (ERROR_ACCESS_DENIED) と同じです。 ユーザーが管理でない場合、BlockNonAdminUserInstall ポリシーが原因で発生する可能性が最も高くなります。詳細については、このリンクを参照してください。 |
トラブルシューティングのために VM でイベント ビューアーを使用する
接続/切断イベントはすべて、仮想マシンで実行されているイベント ビューアーに記録されます。 イベント ビューアーでは、クライアント側関連のエラーを表示することもできます。 Windows ログ\アプリケーションでソース (Microsoft Teams VDI) とイベント ID (0) でフィルター処理します。 エラー コードは、「 VDI 用の新しい Teams ログ 」セクションにあります。
注意
ソースでフィルター処理できるようにするには、管理者特権の PowerShell ウィンドウから次のコマンドを実行する必要があります。
PS C:\Windows\system32> New-EventLog -LogName アプリケーション -Source "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 を手動で使用し、正しいフラグを渡す必要があります。 たとえば、プラグインが現在インストールされていない場合は、/i MsTeamsPluginCitrix.msi /l*vx installer.log.txt msiexec.exe など、ログを使用してインストールできます。
SlimCoreVdi MSIX の展開エラーのトラブルシューティング
特定の GPO (グループ ポリシー) が MSIX のインストールを妨げる可能性があるため、 エンドポイントでの SlimCore MSIX のステージングと登録に関 するセクションを確認してください。
診断情報は、ユーザーのデバイスの詳細なイベント ログにあります。
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では、この設定は既定で有効になっています。 [アプリの設定] > [アプリの詳細設定] > [アプリの詳細設定] > [任意の場所>アプリを取得する場所を選択します。
ログ収集
ログ記録は、次の場所にあります。
- クライアントで次の手順を実行します。
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