製品ドキュメント
Citrix Virtual Apps and Desktops
Current Release Service 2607 LTSR 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
PDFを表示

USB診断ツール

August 29, 2026
寄稿者: 
C C

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

注:

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

要件

セッションホスト

  • オペレーティングシステム
    • Windows 10 1809以降
    • Windows 11 21H2以降
    • Windows Server 2016 以降のバージョン
  • VDA
    • ウィンドウズ: 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

  • デバイス最適化ルール

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

    デバイス最適化ルール

デバイスリスト

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

タグ名 説明
displayName デバイスの一般名を一覧表示します。
ベンダーID ベンダーID
PID 製品ID
インターフェース このサブセクションには、複合デバイスが複数の子デバイスに分割されている場合のすべてのインターフェースが一覧表示されます。
InterfaceNum インターフェース記述子のインデックスを示します
クラス クラスコード
サブクラス サブクラスコード
プロトコル プロトコル
redirectionState ローカルは、デバイスがICA®セッションでリダイレクトされていないことを示します。このセッションは、デバイスがICAセッションでリダイレクトされていることを示します。他のセッションは、デバイスが別のICAセッションでリダイレクトされていることを示します。
deviceType generic は、デバイスに最適化された仮想チャネルがなく、トラフィックがUSB仮想チャネルを介して流れていることを示します。optimized は、デバイスに関連付けられたデータ転送が専用の仮想チャネルを介して行われていることを意味します。
isDenied true は、管理者が設定したポリシー規則によりデバイスがリダイレクトされないことを示します。false は、適用されたポリシーによりデバイスがリダイレクトされることを示します。
denyRule このフィールドは、isDenied が true に設定されている場合に役立ちます。これは、デバイスがリダイレクトされない原因となっているポリシーで設定された特定の規則を管理者に伝えます。
deviceDriver このフィールドは、VDIホストに対応するドライバーが存在するかどうかを示します。

さらに、各デバイスの概要セクションが含まれており、HDXセッション内でのデバイスの可用性をユーザーに知らせます。

推奨事項

このセクションでは、修正または調査が必要な（もしあれば）さまざまなデバイス規則と問題の簡単な概要を説明します。

USB診断ツール
August 29, 2026
寄稿者: 
C C
August 29, 2026
寄稿者: 
C C

この記事の概要

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