USB診断ツール

最終公開日 : Oct 24, 2026
CtxUsbDiagnostics.exe は、Citrix管理者がクライアントで発生するUSBデバイスリダイレクトの問題を迅速に診断し解決するのに役立つ、VDA上のコマンドラインツールです。このユーティリティツールは、HDXセッション内でリダイレクトに失敗しているクライアントに接続されたUSBデバイスに関連する構成の問題をトリアージするために必要な重要な情報を収集します。
> **Note :**
>
> Running Command Prompt or Powershell as an administrator is required to ensure the tool has the necessary permissions to perform system-level operations.
Related information
USB デバイス

要件

セッションホスト

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

クライアントデバイス

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

ツールは何をするのか?

このツールは現在、以下を提供します。
  • SessionID
  • VDAデバイスポリシー（Studioで設定されたデバイスルール）
  • クライアントデバイスとクライアントデバイスポリシー（デバイスルール）
  • デバイスのリスト、それらのリダイレクト状態、および許可または拒否された理由
    USB診断ツール
    注：
    管理者は、すべてのアクティブなセッションのデバイス情報を確認できます。

表示される情報

  • Citrix Studio のルール - バージョン1/2
    • DDCルールは、Studioでレガシーの「クライアントUSBデバイスリダイレクトルール」または「クライアントUSBデバイスリダイレクトルール（バージョン2）」ポリシーが使用されていることを示します。このセクションに記載されている情報には、Citrix®管理者が構成したすべてのルールが一覧表示されます。
    DDCルール - バージョン1
  • クライアントのデフォルトデバイスルール
    • このセクションには、クライアントのレジストリに設定されているルールが一覧表示されます。
    DDCルール バージョン2
  • デバイス最適化ルール
    • このセクションでは、「クライアントUSBデバイス最適化ルール」で設定されているデバイス最適化ルールを一覧表示します。
    デバイス最適化ルール(/en-us/citrix-daas/media/usb-dev-optimization.png)

デバイスリスト

このセクションでは、クライアントエンドポイントに接続されている各デバイスに関する貴重な情報、ハードウェア情報、リダイレクトされているかどうか、正しいデバイスリダイレクトルールが設定されているかどうかなどを一覧表示します。
タグ名 説明
displayName デバイスの共通名を一覧表示します。
ベンダーID ベンダーID
プロダクトID 製品ID
インターフェイス このサブセクションでは、複合デバイスが複数の子デバイスに分割されている場合に、すべてのインターフェイスを一覧表示します。
InterfaceNum インターフェイス記述子のインデックスを示します
クラス クラスコード
サブクラス サブクラスコード
プロトコル プロトコル
redirectionState Local は、デバイスがICA®セッションでリダイレクトされていないことを示します。ThisSession は、デバイスがICAセッションでリダイレクトされていることを示します。OtherSession は、デバイスが別のICAセッションでリダイレクトされていることを示します。
optiEnabled true は、デバイスが最適化されていることを示します。false は、デバイスが最適化されておらず、データ転送がUSB仮想チャネル経由で行われることを示します。
deviceType generic は、デバイスに最適化された仮想チャネルがなく、トラフィックがUSB仮想チャネルを介して流れていることを示します。optimized は、デバイスに関連付けられたデータ転送が専用の仮想チャネルを介して行われていることを意味します。
isDenied true は、管理者が設定したポリシー規則によりデバイスがリダイレクトされないことを示します。false は、適用されたポリシーによりデバイスがリダイレクトされることを示します。
denyRule このフィールドは、isDenied が true に設定されている場合に役立ちます。これは、デバイスがリダイレクトされない原因となっている、ポリシーで設定された特定の規則を管理者に伝えます。