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

USB診断ツール

March 18, 2026
寄稿者: 
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
    • Windows: Citrix Virtual Apps and Desktops™ バージョン2311以降

クライアントデバイス

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

ツールの機能

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

  • セッションID
  • VDAデバイスポリシー（Studioで設定されたデバイスルール）
  • クライアントデバイスとクライアントデバイスポリシー（デバイスルール）

  • デバイスのリスト、そのリダイレクト状態、および許可または拒否された理由

    USB診断ツール

    注：

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

表示される情報

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

  • DDCルールは、Studioでレガシーな「クライアントUSBデバイスリダイレクトルール」または「クライアントUSBデバイスリダイレクトルール（バージョン2）」ポリシーが使用されていることを示します。このセクションに記載されている情報は、Citrix®管理者が構成したすべてのルールをリストします。

    DDCルール - バージョン1

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

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

    DDCルール - バージョン2

デバイス最適化ルール

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

    デバイス最適化ルール

デバイスリスト

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

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

この記事の概要

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