USB診断ツール
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.
必要条件
セッションホスト
- オペレーティングシステム
- ウィンドウズ 10 1809 以降
- ウィンドウズ 11 21H2 以降
- ウィンドウズ サーバー 2016 以降
- VDA
- ウィンドウズ: シトリックス バーチャル アプリケーションズ アンド デスクトップ™ バージョン 2311 以降
クライアントデバイス
- オペレーティングシステム
- Windows 10 1809 以降のバージョン
- Workspace アプリケーション
- Windows: バージョン 2311以降
ツールの機能
このツールは現在、以下を提供します。
- セッションID
- VDAデバイスポリシー(Studioで設定されたデバイスルール)
- クライアントデバイスとクライアントデバイスポリシー(デバイスルール)
-
デバイスのリスト、そのリダイレクト状態、および許可または拒否された理由

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

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

-
デバイス最適化ルール
- このセクションでは、「Client USB device optimization rules」で設定されているデバイス最適化ルールを一覧表示します。

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