Citrix Virtual Apps and Desktops
USB診断ツール
CtxUsbDiagnostics.exe は、Citrix管理者がクライアントで発生するUSBデバイスのリダイレクトの問題を迅速に診断し、解決するのに役立つVDA上のコマンドラインツールです。このユーティリティツールは、HDXセッション内でリダイレクトに失敗しているクライアントに接続されたUSBデバイスに関連する構成の問題をトリアージするために必要な重要な情報を収集します。
注記:
- ツールがシステムレベルの操作を実行するために必要な権限を持っていることを確認するには、管理者としてコマンドプロンプトまたはPowerShellを実行する必要があります。
CtxUsbDiagnostics.exeはC:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exeにあります。 そして、すでに環境変数の一部です。このパスに移動する必要はなく、管理者権限でコマンドプロンプトからこのツールを直接実行できます。
必要条件
セッションホスト
- オペレーティングシステム
- ウィンドウズ 10 1809 以降
- ウィンドウズ 11 21H2 以降
- Windows Server 2016 およびそれ以降のバージョン
- VDA
- ウィンドウズ 環境では、Citrix Virtual Apps and Desktops™ のバージョン 2311 以降が必要です。
クライアントデバイス
- オペレーティングシステム
- Windows 10 のバージョン 1809 以降のOS
- ワークスペースアプリ
- Windows: バージョン 2311 以降
このツールでできること
このツールは現在、以下を提供します。
- セッションID
- VDA デバイスポリシー (Studio で設定されたデバイスルール)
- クライアントデバイスとクライアントデバイスポリシー (デバイスルール)
-
デバイスのリスト、そのリダイレクト状態、および許可または拒否された理由

注:
管理者は、すべてのアクティブなセッションのデバイス情報を確認できます。
表示される情報
-
シトリックス スタジオ 規則 - バージョン 1/2
- DDC ルールは、Studio でレガシーな「クライアント USB デバイスリダイレクトルール」または「クライアント USB デバイスリダイレクトルール (バージョン 2)」ポリシーが使用されていることを示します。このセクションに記載されている情報は、Citrix® 管理者によって構成されたすべてのルールをリストします。

-
クライアントのデフォルトデバイス規則
- このセクションには、クライアントのレジストリに設定されている規則が一覧表示されます。

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

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