次の方法で共有


VDI 2.0 のトラブルシューティング

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

  • SlimCore では最適化されておらず、代わりに表示されます:
    "Azure Virtual Desktop Media Optimized"
    "Citrix HDX Optimized"

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

VDI の新しい Teams ログ

Teams ログは、VM での Teams の実行中に Ctrl + Alt + Shift + 1 を選択することで収集できます。 このアクションにより、ダウンロード フォルダーに 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® 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 のステージングと登録に関 するセクションを確認してください。

診断情報は、ユーザーのデバイスの詳細なイベント ログにあります。

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

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

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

エラー 15615

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

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

ログ収集

ログ記録は、次の場所にあります。

  • クライアントで次の手順を実行します。
    • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
    • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
  • サーバー上:
    • AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\skylib