新しい最適化のトラブルシューティング

Microsoft Teams 用の新しい Slimcore ベースの最適化をトラブルシューティングする場合、ユーザーが従来の WebRTC スタックまたは新しいスタックで最適化されているかどうかを知る必要があります。 また、フォールバック モード "SlimCore メディアが接続されていません" (またはサーバー側レンダリング) になる場合もあります。

  • SlimCore で最適化されていません。代わりに、次のように表示されます:
    "Azure 仮想デスクトップ メディア最適化"
    "Citrix HDX 最適化"

    • 最も可能性の高い原因は、エラーコード 2000 ("プラグインなし") と 2003 ("仮想チャネルは許可されていません") です。
    1. Citrix Studioの「仮想チャネル許可リスト」ポリシーが、MSTEAMS、MSTEAM1、MSTEAM2を許可するように正しく構成されていることを確認します。
    2. エンドポイントにプラグインがあり、プロセス エクスプローラーを備えた VDI クライアントがプラグインを読み込むことを確認します。
      1. プロセス エクスプローラーを実行します。
      2. 下部ウィンドウを有効にし、[DLL] タブに切り替えます。
      3. Azure Virtual Desktop で、msrdc.exe プロセスを探し、MsTeamsPluginAvd.dll が読み込まれていることを確認します。
      4. Citrix で、wfica32.exe プロセスを探し、MsTeamsPluginCitrix.dll が読み込まれていることを確認します。
    3. Teams アプリを再起動します。 プラグインが初めて検出されたときには、WebRTC から SlimCore に移行するために 1 回の再起動が必要です。
    4. 問題が解決しない場合は、仮想マシン (VM) でMicrosoft Teams VDI 関連のエラー (Teams 24123.X.X.X 以降) をチェック イベント ビューアーします。
  • SlimCore で最適化されておらず、代わりに「Azure Virtual Desktop SlimCore メディアが接続されていません」または「Citrix SlimCore メディアが接続されていません」と表示されます。

Teams クライアント正常性ダッシュボード

Teams 管理センター内の Teams クライアントの正常性は、管理者が VDI の問題のトラブルシューティングと解決に役立つ一連のデータ、分析情報、ツールを含むまったく新しいページです。 管理者は [問題] タブで、[VDI 最適化エラー] エラーを見つけることができ、エンド ユーザーの生産性に影響を与えたり、さらなるエスカレーションを引き起こしたりする前に、問題を管理して修正するための説明と修復アクションを確認できます。 これらのエラーは通常、GPO、ネットワーク設定、構成、または AppX のいずれかを介して対処できます。 これらは、プラグインが SlimCore をインストール/読み込み/展開しようとしたときの MSIX 関連のアクティビティ、または Citrix 仮想チャネルの許可リストなどの構成が見つからない、またはプラグインが見つからないことが原因で発生します。 エラー コードは次の表に示されています。

ヒント

TCH で公開される情報は、プロアクティブおよびリアクティブ監視ツールの両方として、管理者にとって非常に重要です。 Microsoft では、毎日または毎週情報を確認し、対応する自動レポートを作成することをお勧めします。

Teams のクライアント正常性ページを示すスクリーンショット。

VDI の Teams ログ

VM で Teams を実行しているときに Ctrl+Alt+Shift+1 キーを押すと、Teams ログを収集できます。 この操作により、[ダウンロード] フォルダーに ZIP フォルダーが作成されます。 PROD-WebLogs-*.zip ファイル内で、Core フォルダを探します。

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® リモート デスクトップ", "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 は、VM で実行されている Teams デスクトップ クライアントのバージョンに関連付けられています。
    • remoteSlimcoreVersion は、エンドポイントで使用可能な SlimCore VDI のバージョンです。
    • nodeId は、エンドポイントに関連付けられた一意の ID です。
    • clientOsVersion は、エンドポイントの OS バージョンです。
    • rdClientVersion は、エンドポイントで実行されているリモート デスクトップ クライアントのバージョンであり、VM への接続に使用されます。
    • rdClientProductName は、エンドポイントで実行されているリモート デスクトップ クライアントの名前です。
    • pluginVersion は、リモート デスクトップ クライアントに統合されているプラグインのバージョンです。

Diagnostics-logs.txt

このファイルは Weblogs\user(..) の下にもあります。 VDI 接続関連の問題をさらに調査するには、キーワード (keyword) 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) を確立しようとしたときに発生するエラーです。

ここに記録されたコードは、次の表を使用してマッピングする必要があります。

Standard エラー コード loadErrc または deployErrc 定義 メモ
0 0 OK エラーではありません。 「SlimCore Connected」成功、ユーザーは適切に最適化されました
5 43 ERROR_ACCESS_DENIED MsTeamsVdi.exe プロセス起動時に失敗しました。 BlockNonAdminUserInstall が有効になっていると、このエラーが発生する可能性があります。 または、ユーザーが SlimCoreVDI の登録を完了しなかった後に、エンドポイントが複数の MSIX パッケージの登録でビジー状態になっている可能性があります。
110 ERROR_OPEN_FAILED Windows バックグラウンド アクセス ポリシーにより BITS ('BG_E_BLOCKED_BY_BACKGROUND_ACCESS_POLICY') がブロックされ、最適化中に SlimCore のダウンロードが防止されます。 AVD/W365 ユーザーの場合、Windows アプリ にバックグラウンド アプリのアクセス許可がない場合があります - Windows の設定/アプリ/アプリ/インストール済みアプリ/Windows アプリで [>このアプリをバックグラウンドで実行する] を [常に] に設定します。 このオプションが表示されない場合は、HKCU\Software\Microsoft\Windows\CurrentVersion\BackgroundAccessApplications で、GlobalUserDisabled が 1 に設定されているかどうかチェックし、0 に変更します
403 3227 HTTP_STATUS_FORBIDDEN SlimCore MSIX のダウンロードがブロックされている何かがあるため、ネットワーク チームとプロキシ チームに確認してください。 HTTP ステータス 403 - サーバーは要求を理解しましたが、要求を満たすことを拒否しました。
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 秒のタイムアウト)。 症状としては、SlimCore 最適化への移行が遅い、"SlimCore メディアが接続されていません" が発生し、待機または再起動後に最終的に回復する可能性があります。 最も考えられる根本原因は、SlimCore MSIX のデプロイ/登録の完了が遅すぎることです。
1722 13779 RPC_S_SERVER_UNAVAILABLE リモート プロシージャ コール (RPC) サーバーを利用できません。 MsTeamsVdi.exe は、SlimCore の起動時に依存している Windows サービス コンポーネント (おそらくアプリ準備サービス (ARS)、パッケージ マネージャー API、またはパッケージ登録 API) と通信できませんでした。 これらのコンポーネントが使用できないか、ハングしているか、再起動している場合は、RPC エラーが予想されます。 一般的なシナリオは、低速、ユーザー ログオンで過負荷になるシン クライアント、または AppX 登録が遅れることです。 SlimCore 登録の破損または不完全なことも原因である可能性があります。 最終的に最適化が成功した場合は、1722 をハード MsTeamsVdi.exe スタートアップ エラーではなく一時的な状態として扱います。 追加のログ情報は、エンドポイントのイベント ビューアー (AppXDeployment-Server/Operational および AppxPackagingOM/Operational) から取得できます。
2000 16002 プラグインなし エンドポイントに MsTeamsPlugin がないか、インストールされていても読み込まれませんでした (プロセス エクスプローラーでチェックしてください)。
2001 16008 仮想チャネルは使用できません Citrix VDA (仮想配信エージェント) WFAPI または Omnissa Agent Blast API でのエラー
2003 16026 カスタム仮想チャネル (MSTEAMS、MSTEAM1、MSTEAM2) は、Citrix Studio ポリシーによりブロックされています VDI 2.0 の記事の 「Citrix 仮想チャネル許可リスト 」セクションを確認します。
2004 16032 Citrix Workspaceアプリのバージョンはサポートされていません。 アップグレードしてください
2005 16043 Teams は公開済みアプリ (Citrix) または RemoteApp (AVD/Windows 365) として実行されています ユーザーが最小バージョン要件を満たしていない - この場合、Teams は SlimCore を読み込まず、ユーザーは常に WebRTC で最適化されます。
2008 16066 AVD/365 の MAC 用 Windows アプリは、サポートされていない App Store からのものです。 ストア以外の Windows アプリのみがサポートされています。
3000 24002 SlimCore デプロイは必要ありません このコードは実際にはエラーではありません。 これは、ユーザーが SlimCore を使用した新しい最適化アーキテクチャを使用していることを示す良い指標です。
3001 24010 SlimCore は既に読み込まれています このコードは実際にはエラーではありません。 これは、ユーザーが SlimCore を使用した新しい最適化アーキテクチャを使用していることを示す良い指標です。
3002 24018 ローカル スリムコアなし エンドポイントで SlimCore が正常にダウンロードされませんでした。
3004 24035 プラグインが応答しない Teams を再起動してみてください。 これは通常、プラグインがメディア エンジンのステージングでビジー状態の一時的なエラーです。 このエラーは、仮想チャネルの確立に失敗する 2000 とは異なります。 エラー 3004 では、トランスポートが確立されていますが、プラグインが 'ClientHello' で Teams に応答することはありません
3005 24043 ダウンロード中のプラグイン タイムアウト 2 分以内に MSIX をダウンロードできませんでした。
3007 24058 読み込みタイムアウト SlimCore のダウンロードまたはインストールがタイムアウトしました (インターネットの速度が遅い、または App Readiness Service がビジー状態です)。
3021 24170 使用可能な SlimCore パッケージがありません 一部の MSIX パッケージ (通常はフレームワーク) は存在しますが、使用可能な組み合わせがありません (通常はホスト MSIX パッケージがありません)。 一部のユーザー設定がホストのインストールを妨げています。
4000 ERROR_WINS_INTERNAL コマンドの処理中に WINS でエラーが発生しました。
4390 ERROR_NOT_A_REPARSE_POINT 統合された書き込みフィルターと RAM ディスク オーバーレイを備えたシン クライアントでの SlimCore MSIX 関連のエラー。 このセクションをチェックしてください
12002 ERROR_INTERNET_TIMEOUT エンドポイントでのインターネット接続の問題。 HTTP 要求がタイムアウトしました。ユーザーに推奨されるアクションは、 NAT ツール を実行してネットワーク上の問題を検出し、問題を解決することです
12030 ERROR_INTERNET_CONNECTION_ABORTED エンドポイントでのインターネット接続の問題。 Microsoft CDN サーバーとの接続が異常終了しました。 ユーザーに推奨されるアクションは、 NAT ツール を実行してネットワーク上の問題を検出し、問題を解決することです
15615 1951 ERROR_INSTALL_POLICY_FAILURE SlimCore MSIX 関連のエラー。 このアプリをインストールするには、Windows 開発者ライセンス、またはサイドローディング対応システムが必要です。 AllowAllTrustedApps regkey が 0 に設定されている可能性がありますか?
15616 ERROR_PACKAGE_UPDATING SlimCore MSIX 関連のエラー。 "現在更新中のため、アプリケーションを開始できません" ハード デプロイの失敗ではない一時的な MSIX ライフサイクル競合状態です。 AppX/MSIX サブシステムがエンドポイントで SlimCore パッケージの更新、登録、修復、または交換を行っている間に、プラグインが SlimCore を起動または読み込もうとすると、Windows はこれを返します。 最終的に最適化が成功した場合は、15616 を配置エラーではなく再試行可能な条件として扱います。 ユーザーが「SlimCore メディアが接続されていません」のままになっている場合、または SlimCore で最適化されていない場合にのみ、さらに調査してください。
15618 ERROR_PACKAGES_IN_USE SlimCore MSIX 関連のエラー。 "変更するリソースが現在使用中であるため、パッケージをインストールできませんでした。"
15700 APPMODEL_ERROR_NO_PACKAGE プロセスにはパッケージ ID がありません。 %LOCALAPPDATA%\Microsoft\WindowsApps には MsTeamsVdi のエイリアスはありません。 エラーを再現している間、フィードバック Hub ログが必要です (カテゴリとして [開発者プラットフォーム]、サブカテゴリとして [アプリの展開] を選択してください)
16389 E_FAIL reported by パッケージ マネージャー 通常、ロード エラー コード 5 (ERROR_ACCESS_DENIED) と同じです。 ユーザーが管理でない場合、BlockNonAdminUserInstall ポリシーによって発生した可能性が高いです。詳細については、こちらのリンクを確認してください。 Intune MDM でもこの値を設定できます。 状況によっては、Windows はエラー 16389 (E_FAIL) を一般的なエラーとして報告するため、BlockNonAdminUserInstall が唯一の根本原因ではありません。以下の詳細な説明を参照してください。

トラブルシューティングに VM でイベント ビューアーを使用する

すべての接続/切断イベントは、仮想マシンで実行されているイベント ビューアーに記録されます。 イベント ビューアーは、クライアント側に関連するエラーを表示することもできます。 Windows ログ\アプリケーションの下のソース (Microsoft Teams VDI) とイベント ID (0) でフィルター処理します。 エラー コードは、「 VDI の Teams ログ」 セクションに記載されています。

注意

ソースでフィルター処理できるようにするには、管理者特権の PowerShell ウィンドウから次のコマンドを実行する必要があります。

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

プラグインのデプロイ エラーのトラブルシューティング

診断情報は、ユーザーのデバイスの詳細イベント ログに記載されています。 インストール後、MsTeamsPluginCitrix.dll CWA(Citrix Workspaceアプリ)フォルダーに書き込まれます。 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 のステージングと登録 を確認してください。

診断情報は、ユーザーのデバイスの詳細イベント ログに記載されています。

  1. Microsoft > Windows >イベント ビューアー (ローカル) > [アプリケーションとサービス] ログに移動します。

  2. 次のカテゴリで使用可能なログを確認します。

    • AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
    • AppXDeployment-Server > Microsoft-Windows-AppXDeploymentServer/Operational
  3. AppXDeployment-Server の下のログを確認します。

エラー 16389

エラー 16389 (E_FAIL) は、多くの場合、Windows パッケージ マネージャー/AppX スタックで何らかの根本的なエラーが発生したものの、汎用的なE_FAIL値のみが表示されたエラーです。 最も可能性の高い原因は、BlockNonAdminUserInstall ポリシーです。 ApplicationManagement のこの CSP ポリシーは、管理者以外のユーザーが Windows アプリ パッケージ (SlimCore ホストやフレームワークなど) をインストールする機能を管理します。

注意

この問題は、エンドポイントで MDM ポリシーの ApplicationManagement/BlockNonAdminUserInstall (Intune 設定カタログ→アプリ パッケージの展開→管理者以外のユーザーのインストールをブロック) が 1 (有効) に設定されている場合にも発生する可能性があります。 有効なポリシーは、HKLM\SOFTWARE\Microsoft\PolicyManager\current\device\ApplicationManagement\BlockNonAdminUserInstall = 1 (REG_DWORD) から読み取られます。 AppX Deployment Server は、呼び出し元 (msrdc.exe など) に E_ACCESSDENIED (0x80070005) を返します。 Teams VDI プラグインは、これをwindows_error_16389として表面化し、新しい最適化が初期化されていない→呼び出しが最適化されていないか、WebRTC (使用可能な場合) にフォールバック→ SlimCore 登録を中止します。

原因 可能性 メモ
BlockNonAdminUserInstall 非常に高い
AppLocker/WDAC
SlimCore ホストと FWK 登録の不一致 プラグイン 2026.29.1.4 で修正
共有キオスクのマルチユーザー登録の問題 プラグイン 2026.29.1.4 で修正
一時フォルダーへのアクセス拒否 Medium-High

エラー 15615

エラー 15615 は通常、Windows パッケージ マネージャーが SlimCoreVDI を含む MSIX パッケージをインストールできないことを意味します。

  • エンドポイントがその MSIX のデジタル署名を信頼していることを確認します ([MSIX > プロパティ] > [デジタル署名 > 詳細] に移動します)。 ストアに適した有効な Microsoft 署名ですが、顧客が何か特別な情報を構成している可能性があります。
  • AllowAllTrustedApps ポリシーを有効にしてみてください。
  • 信頼できるストア以外のソースからのアプリのサイドローディングを許可します。
    • Windows 10 では、この設定は既定で有効になっているため、無効になっている場合はここで変更します: 設定>更新とセキュリティ > 開発者向け > アプリのサイドロード。
    • Windows 11 では、この設定は既定で有効になっています: [アプリ>設定] > [アプリの詳細設定] > どこでもアプリを入手する場所>選択します。

ログ収集

ログ記録は、次の場所で確認できます。

  • クライアント上 (ホストとフレームワークによる新しい分割アーキテクチャの前の古い SlimCores の場合):

    • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
    • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
  • クライアント上 (ホストとフレームワークの分割アーキテクチャを持つ新しい SlimCores の場合):

    • 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
  • サーバー上:

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