Citrix DaaS™

USB診断ツール

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

注記:

ツールがシステムレベルの操作を実行するために必要な権限を確保するには、管理者としてコマンドプロンプトまたはPowerShellを実行する必要があります。

要件

セッションホスト

-  オペレーティングシステム
-  Windows 10 1809以降
-  Windows 11 21H2以降
-  Windows Server 2016以降
  • VDA
    • Windows: Citrix Virtual Apps and Desktops™バージョン2311以降

クライアントデバイス

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

ツールの機能

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

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

注記:

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

表示される情報

-  **Citrix Studioルール - バージョン1/2**

-  DDCルールは、Studioでレガシーな「**Client USB device redirection rules**」または「**Client USB device redirection rules (Version 2)**」ポリシーが使用されていることを示します。このセクションにリストされている情報は、Citrix®管理者が構成したすべてのルールをリストします。

![DDC-Rules-Ver1](/en-us/citrix-daas/media/ddc-rules-ver1.png)

-  **クライアントのデフォルトデバイスルール**

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

![DDC-Rules-Ver2](/en-us/citrix-daas/media/ddc-rules-ver2.png)
  • デバイス最適化ルール

    • このセクションには、「Client USB device optimization rules」で設定されているデバイス最適化ルールがリストされます。

    Device Optimization rules

デバイスリスト

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

タグ名 説明
displayName デバイスの一般名をリストします。
vid ベンダーID
pid 製品ID
Interfaces このサブセクションには、複合デバイスが複数の子デバイスに分割されている場合のすべてのインターフェイスがリストされます。
InterfaceNum インターフェイス記述子のインデックスを示します。
class クラスコード
subclass サブクラスコード
protocol プロトコル
redirectionState Localは、デバイスがICA®セッションでリダイレクトされていないことを示します。ThisSessionは、デバイスがICAセッションでリダイレクトされていることを示します。OtherSessionは、デバイスが別のICAセッションでリダイレクトされていることを示します。
optiEnabled trueは、デバイスが最適化されていることを示します。falseは、デバイスが最適化されておらず、データ転送がUSB仮想チャネルを介して行われることを示します。
deviceType genericは、デバイスに最適化された仮想チャネルがなく、トラフィックがUSB仮想チャネルを介して流れていることを示します。optimizedは、デバイスに関連付けられたデータ転送が専用の仮想チャネルを介して行われていることを意味します。
isDenied trueは、管理者が設定したポリシールールによりデバイスがリダイレクトされていないことを示します。falseは、適用されたポリシーによりデバイスがリダイレクトされていることを示します。
denyRule このフィールドは、isDeniedtrueに設定されている場合に役立ちます。これにより、管理者は、デバイスがリダイレクトされない原因となっているポリシー内の特定のルールを知ることができます。
USB診断ツール