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.
要件
セッションホスト
-
オペレーティングシステム
-
Windows 10 1809以降
-
Windows 11 21H2以降
-
Windows Server 2016年以降
-
-
VDA
-
Windows版: Citrix Virtual Apps and Desktops™ バージョン2311 以降
-
クライアントデバイス
-
オペレーティングシステム
-
Windows 10 1809 以降
-
-
ワークスペースアプリ
-
Windows: バージョン 2311 以降
-
ツールは何をしますか?
このツールは現在、以下を提供します。
-
VDAデバイスポリシー（Studioで設定されたデバイスルール）
-
クライアントデバイスとクライアントデバイスポリシー（デバイスルール）
-
デバイスのリスト、そのリダイレクト状態、および許可または拒否された理由
注記：管理者は、すべてのアクティブなセッションのデバイス情報を確認できます。
表示される情報
-
DDCルール - バージョン1/2
-
DDCルールは、Studioにおけるレガシーな「クライアントUSBデバイスリダイレクトルール」または「クライアントUSBデバイスリダイレクトルール (バージョン 2)」ポリシーの使用を示します。このセクションに記載されている情報は、Citrix®管理者が構成したすべてのルールを一覧表示します。
-
-
クライアントのデフォルトデバイスルール
-
このセクションには、クライアントのレジストリに設定されているルールが一覧表示されます。
-
デバイスリスト
このセクションには、クライアントエンドポイントに接続されている各デバイスに関する貴重な情報、ハードウェア情報、リダイレクトされているかどうか、正しいデバイスリダイレクトルールが設定されているかどうかなどが一覧表示されます。
| タグ名 | 説明 |
|---|---|
| displayName | デバイスの一般名を一覧表示します。 |
| ベンダーID | ベンダーID |
| プロダクトID | プロダクトID |
| インターフェイス | このサブセクションには、複合デバイスが複数の子デバイスに分割されている場合のすべてのインターフェイスが一覧表示されます。 |
| redirectionState | Local は、デバイスがICA®セッションでリダイレクトされていないことを示します。ThisSession は、デバイスがICAセッションでリダイレクトされていることを示します。OtherSession は、デバイスが別のICAセッションでリダイレクトされていることを示します。 |
| optiEnabled | true はデバイスが最適化されていることを示します。false はデバイスが最適化されておらず、データ転送がUSB仮想チャネル経由で行われることを示します。 |
| deviceType | generic は、デバイスに最適化された仮想チャネルがなく、トラフィックがUSB仮想チャネルを介して流れていることを示します。optimized は、デバイスに関連付けられたデータ転送が専用の仮想チャネルを介して行われていることを意味します。 |
| isDenied | true は、管理者が設定したポリシー規則によりデバイスがリダイレクトされていないことを示します。false は、適用されたポリシーによりデバイスがリダイレクトされていることを示します。 |
| denyRule | このフィールドは、isDenied が true に設定されている場合に役立ちます。これにより、デバイスがリダイレクトされない原因となっているポリシー内の特定の規則セットを管理者に伝えます。 |