Citrix Virtual Apps and Desktops

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以降

このツールの概要

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

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

    USB診断ツール

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

表示される情報

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

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

    DDC規則Ver1

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

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

    DDC規則Ver2

デバイス一覧

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

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