Citrix Virtual Apps and Desktops

USB診断ツール

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

注:

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

必要条件

セッションホスト

  • オペレーティングシステム
    • Windows 10 1809 またはそれ以降のバージョン
    • Windows 11 21H2 またはそれ以降のバージョン
    • ウィンドウズ サーバー 2016 以降
  • VDA
    • ウィンドウズ オペレーティングシステムの場合、Citrix Virtual Apps and Desktops™ のバージョン 2311 以降が必要です。

クライアントデバイス

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

このツールでできること

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

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

    USB診断ツール

    注:

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

表示される情報

  • シトリックス スタジオ ルール - バージョン 1/2

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

    DDC-ルール-バージョン1

  • クライアントのデフォルトデバイス規則

    • このセクションでは、クライアントのレジストリに設定されている規則を一覧表示します。

    DDC-ルール-バージョン2

  • デバイス最適化規則

    • このセクションでは、「クライアントUSBデバイス最適化規則」に設定されているデバイス最適化規則を一覧表示します。

    デバイス最適化ルール

デバイスリスト

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

Tag Name Description
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 に設定されている場合に役立ちます。デバイスがリダイレクトされない原因となっているポリシーに設定された特定の規則を管理者に伝えます。
USB診断ツール