Citrix DaaS

USB診断ツール

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

> **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以降
  • Workspaceアプリ
    • Windows:バージョン2311以降

このツールの概要

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

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

    USB診断ツール

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

表示される情報

  • Citrix Studio規則 - バージョン1/2

    • DDC規則は、Studioで従来の「クライアントUSBデバイスリダイレクト規則」または「クライアントUSBデバイスリダイレクト規則(バージョン2)」ポリシーを使用することを示します。このセクションに記載されている情報には、Citrix管理者によって構成されたすべての規則が表示されています。

    DDC規則バージョン1

  • クライアントのデフォルトのデバイス規則

    • このセクションでは、クライアントのレジストリで設定されている規則を表示します。

    DDC規則バージョン2

  • デバイス最適化規則

    • このセクションでは、「クライアントUSBデバイス最適化規則」で設定されたデバイス最適化規則を一覧表示します。

    デバイス最適化規則

デバイス一覧

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

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