製品ドキュメント
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDFを表示

USB診断ツール

November 25, 2025
寄稿者: 
C

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

メモ :

  • ツールにシステムレベルの操作を実行するために必要な権限があることを確認するには、コマンドプロンプトまたはPowershellを管理者として実行する必要があります。
  • CtxUsbDiagnostics.exeはC:\Program Files\Citrix\HDX\bin\CtxUsbDiagnostics.exeにあります。 これは既に環境変数の一部になっています。 このパスに移動する必要はなく、管理者特権を使用してコマンドプロンプトでこのツールを直接実行できます。

要件

セッションホスト

  • オペレーティングシステム
    • 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規則Ver1

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

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

    DDC規則Ver2

  • デバイス最適化規則

    • このセクションでは、「クライアント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 このフィールドは、isDeniedがtrueに設定されている場合に役立ちます。 これにより、デバイスがリダイレクトされなくなる原因のポリシーに設定された特定の規則が、管理者に通知されます。
USB診断ツール
November 25, 2025
寄稿者: 
C
November 25, 2025
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.