Citrix Virtual Apps and Desktops 7 2311

USB診断ツール

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

> **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 or later
  • VDA
    • Windows: Citrix Virtual Apps and Desktops™ Version 2311 or later

クライアントデバイス

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

ツールの機能

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

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

    USB診断ツール

    注:

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

表示される情報

  • DDCルール - バージョン1/2

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

    DDCルール バージョン1

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

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

    DDCルールバージョン2

デバイスリスト

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

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