USB診断ツール
CtxUsbDiagnostics.exeは、Citrix管理者がクライアントで発生するUSBデバイスリダイレクトの問題を迅速に診断し解決するのに役立つ、VDA上のコマンドラインツールです。このユーティリティツールは、HDXセッション内でリダイレクトに失敗しているクライアントに接続されたUSBデバイスに関連する構成の問題をトリアージするために必要な重要な情報を収集します。
注 :
-
ツールがシステムレベルの操作を実行するために必要な権限を持っていることを確認するには、コマンドプロンプトまたはPowershellを管理者として実行する必要があります。
-
CtxUsbDiagnostics.exeはC:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exeにあります。 そして、すでに環境変数の一部です。このパスに移動する必要はなく、昇格された権限でコマンドプロンプトからこのツールを直接実行できます。
要件
セッションホスト
-
オペレーティングシステム
-
Windows 10 1809 以降
-
Windows 11 21H2 以降
-
ウィンドウズ サーバー 2016 以降
-
-
VDA
-
Windows版: Citrix Virtual Apps and Desktops™ バージョン 2311 以降
-
クライアントデバイス
-
オペレーティングシステム
-
Windows 10 1809 以降
-
-
ワークスペースアプリ
-
Windows: バージョン 2311 以降
-
ツールの機能?
このツールは現在、以下を提供します。
-
SessionID
-
VDAデバイスポリシー（Studioで設定されたデバイスルール）
-
クライアントデバイスとクライアントデバイスポリシー（デバイスルール）
-
デバイスのリスト、そのリダイレクト状態、および許可または拒否された理由
注記：管理者は、すべてのアクティブなセッションのデバイス情報を確認できます。
表示される情報
-
Citrix Studio ルール - バージョン 1/2
-
DDCルールは、Studioにおけるレガシーな「クライアントUSBデバイスリダイレクトルール」または「クライアントUSBデバイスリダイレクトルール (バージョン 2)」ポリシーの使用を示します。このセクションに記載されている情報は、Citrix®管理者が構成したすべてのルールを一覧表示します。
-
-
クライアントのデフォルトデバイスルール
-
このセクションには、クライアントのレジストリに設定されているルールが一覧表示されます。
-
-
デバイス最適化ルール
-
このセクションには、「クライアントUSBデバイス最適化ルール」で設定されているデバイス最適化ルールが一覧表示されます。
-
デバイスリスト
このセクションには、クライアントエンドポイントに接続されている各デバイスに関する貴重な情報（ハードウェア情報、リダイレクトされているかどうか、正しいデバイスリダイレクトルールが設定されているかどうかなど）が一覧表示されます。
| タグ名 | 説明 |
|---|---|
| displayName | デバイスの一般的な名前を一覧表示します。 |
| ベンダーID | ベンダーID |
| 製品ID | 製品ID |
| インターフェイス | このサブセクションでは、複合デバイスが複数の子デバイスに分割されている場合に、すべてのインターフェイスを一覧表示します。 |
| InterfaceNum | インターフェイス記述子のインデックスを示します |
| クラス | クラスコード |
| サブクラス | サブクラスコード |
| プロトコル | プロトコル |
| リダイレクト状態 | ローカルは、デバイスがICA®セッションでリダイレクトされていないことを示します。このセッションは、デバイスがICAセッションでリダイレクトされていることを示します。他のセッションは、デバイスが別のICAセッションでリダイレクトされていることを示します。 |
| optiEnabled | true は、デバイスが最適化されていることを示します。false は、デバイスが最適化されておらず、データ転送が USB 仮想チャネル経由で行われることを示します。 |
| デバイスタイプ | 汎用は、デバイスに最適化された仮想チャネルがなく、トラフィックがUSB仮想チャネルを介して流れていることを示します。最適化済みは、デバイスに関連付けられたデータ転送が専用の仮想チャネルを介して行われていることを意味します。 |
| 拒否済み | trueは、管理者が設定したポリシー規則によりデバイスがリダイレクトされないことを示します。falseは、適用されたポリシーによりデバイスがリダイレクトされることを示します。 |
| 拒否ルール | このフィールドは、拒否済みがtrueに設定されている場合に役立ちます。これは、デバイスがリダイレクトされない原因となっているポリシーで設定された特定のルールを管理者に伝えます。 |