Citrix Virtual Apps and Desktops

セッションホスト

CtxUsbDiagnostics.exe は、VDA 上のコマンドラインツールであり、Citrix 管理者がクライアントで発生する USB デバイスリダイレクトの問題を迅速に診断し、解決するのに役立ちます。このユーティリティツールは、HDX セッション内でリダイレクトに失敗しているクライアントに接続された USB デバイスに関連する構成の問題をトリアージするために必要な重要な情報を収集します。

注:

  • コマンドプロンプトまたは PowerShell を管理者として実行すると、ツールがシステムレベルの操作を実行するために必要な権限を確実に持つことができます。
  • CtxUsbDiagnostics.exeC:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exe にあり、すでに環境変数の一部です。このパスに移動する必要はなく、管理者権限でコマンドプロンプトからこのツールを直接実行できます。
  • 要件

セッションホスト

-  オペレーティングシステム
-  Windows 10 1809 以降
-  Windows 11 21H2 以降
-  Windows Server 2016 以降
-  VDA
-  Windows: Citrix Virtual Apps and Desktops™ バージョン 2311 以降

クライアントデバイス

  • オペレーティングシステム
    • Windows 10 1809 以降
  • Workspace アプリ
    • Windows: バージョン 2311 以降

ツールの機能

このツールは現在、以下を提供します。

  • セッションID
  • VDA デバイスポリシー (Studio で設定されたデバイスルール)
  • クライアントデバイスとクライアントデバイスポリシー (デバイスルール)
    • デバイスのリスト、そのリダイレクト状態、および許可または拒否された理由

    USB-Diagnostic-Tool

    • 注:

      管理者は、すべてのアクティブなセッションのデバイス情報を確認できます。

表示される情報

-  **Citrix Studio ルール - バージョン 1/2**

-  DDC ルールは、Studio でレガシーな「**クライアント USB デバイスリダイレクトルール**」または「**クライアント USB デバイスリダイレクトルール (バージョン 2)**」ポリシーが使用されていることを示します。このセクションにリストされている情報は、Citrix® 管理者によって構成されたすべてのルールをリストします。

![DDC-Rules-Ver1](/en-us/citrix-virtual-apps-desktops/media/ddc-rules-ver1.png)

-  **クライアントのデフォルトデバイスルール**

-  このセクションには、クライアントのレジストリに設定されているルールがリストされます。

![DDC-Rules-Ver2](/en-us/citrix-virtual-apps-desktops/media/ddc-rules-ver2.png)
  • デバイス最適化ルール

    • このセクションには、「クライアント USB デバイス最適化ルール」で設定されているデバイス最適化ルールがリストされます。

    Device Optimization rules

デバイスリスト

このセクションには、クライアントエンドポイントに接続されている各デバイスに関する貴重な情報、ハードウェア情報、リダイレクトされているかどうか、正しいデバイスリダイレクトルールが設定されているかどうかなどがリストされます。

タグ名 説明
displayName デバイスの一般的な名前をリストします。
vid ベンダーID
pid プロダクトID
Interfaces このサブセクションには、複合デバイスが複数の子デバイスに分割されている場合のすべてのインターフェースがリストされます。
InterfaceNum インターフェース記述子のインデックスを示します。
class クラスコード
subclass サブクラスコード
protocol プロトコル
redirectionState Local は、デバイスが ICA® セッションでリダイレクトされていないことを示します。ThisSession は、デバイスが ICA セッションでリダイレクトされていることを示します。OtherSession は、デバイスが別の ICA セッションでリダイレクトされていることを示します。
deviceType generic は、デバイスが最適化された仮想チャネルを持たず、トラフィックが USB 仮想チャネルを介して流れていることを示します。optimized は、デバイスに関連付けられたデータ転送が専用の仮想チャネルを介して行われていることを意味します。
isDenied true は、管理者が設定したポリシー規則によりデバイスがリダイレクトされていないことを示します。false は、適用されたポリシーによりデバイスがリダイレクトされていることを示します。
denyRule このフィールドは、isDeniedtrue に設定されている場合に役立ちます。デバイスがリダイレクトされない原因となっているポリシー内の特定のルールを管理者に伝えます。
セッションホスト