トラブルシューティング

USBリダイレクト関連の問題をトリアージするには、以下の手順に従ってください。

1. USBリダイレクトのシステム要件が満たされていることを確認します。これには、適切なCVADおよびCWAバージョン、サポートされているデバイス、および検討中のOSプラットフォーム上のデバイスドライバーが含まれます。

2. 環境で使用されているコンポーネントのバージョンとプラットフォームに基づいて、構成が適切であることを確認します。レガシー構成設定を必要とするコンポーネントの詳細については、「Legacy USB Redirection Configuration」の注記を参照してください(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/devices/usb-devices/legacy-usb-redirection-configuration.html)。

3. クライアントが列挙したデバイスの下にデバイスがリストされていることを確認します。

   1. Workspace 環境設定ツールバー: Workspace アプリの環境設定ツールバーのDevicesタブに列挙されているデバイスを確認します（CWAアイコン > Connection Center > 環境設定 を右クリックし、Devices タブをクリックします）。

   2. CtxUsbDiagnostics.exe（推奨）：このツールをコマンドプロンプトウィンドウで実行します。出力には、特定のセッションに関するデバイス固有の情報が表示されます。デバイスがリダイレクトされているかどうか、また、デバイスルールセットがデバイスのリダイレクトを妨げているかどうかを示します。詳細については、「Diagnostics Tool」を参照してください。

   3. USBViewまたはその他のサードパーティツール：エンドポイント/クライアントマシンでUSBViewのようなサードパーティツールを実行し、デバイスがエンドポイントで検出されていることを確認します。

4. デバイスが列挙されている場合：

   1. 特定のデバイスについてCtxUsbDiagnosticsツールの出力に拒否ルールが表示される場合は、Studioで構成されているポリシーを確認し、バージョン2ポリシーでルールが正しく設定されていることを確認します。拒否ルールがStudioポリシーに表示されない場合は、クライアント側ポリシー、そして最後にクライアント側デフォルトの順に確認して、一致する拒否ルールを見つけます。

   2. CtxUsbDiagnosticsの出力に拒否ルールがない場合、CWAはPreferencesウィンドウのデバイスタブ（Devices > Manage devices）で適切なボタンをチェック/クリックすることで、デバイスのリダイレクトを許可します。一度リダイレクトされたデバイスはセッションで利用可能になります。これは、HDXセッションでデバイスマネージャー/USBViewまたは同様のアプリケーションをチェックすることで確認できます。

5. セッション内にデバイスが表示されない場合：

   1. VDAホストに正しいデバイスドライバーが正しくインストールされていない可能性があります。VDAホストに最新バージョンのデバイスドライバーが正しくインストールされていることを確認してください。一部のデバイスドライバーはターミナルサーバーマシンでサポートされていないため、リダイレクトしようとしているデバイスがそうでないことを確認してください。

   2. クライアントエンドポイントでデバイスが使用されていないことを確認します。一部のデバイスはクライアントエンドポイントにもドライバーのインストールが必要であり、これがセッションでのリダイレクトを妨げる可能性があります。

6. クライアントエンドポイントでUSB関連のルールが正しく設定されていることを確認します。

   1. ウィンドウズ版CWA :

      1. クライアント上のグループポリシー（詳細とSSを追加）が適切に設定されており、Studioで設定されたルールと競合しないことを確認します。

      2. クライアントのレジストリ内のデフォルトルールを確認します。

      

      (HKLM\SOFTWARE\Wow6432Node\Citrix\PortICA\GenericUSB\DeviceRules) are appropriately set and not in conflict with the rules set in Studio and client group policy.

   2. Linux版CWA - Linux版CWAの問題をトリアージするには、Linux版CWAのUSBドキュメントを参照してください。

   3. Mac版CWA - Mac版CWAの問題をトリアージするには、Mac版CWAを参照してください。

注:

• TSVDAでは、オーディオデバイスはUSBリダイレクトの使用がデフォルトでブロックされています。これらのデバイスを使用する推奨される方法は、最適化されたオーディオVCを使用することです。

• 場合によっては、デバイスを分割するための正しいデバイスリダイレクトルールが設定されているにもかかわらず、USB複合デバイスが自動的に分割されないことがあります。この問題は、デバイスが低電力モードになっているために発生します。このような場合、低電力モードに入る子デバイスがデバイスリストに表示されないことがあります。この問題を解決するには、以下の回避策を使用できます。

  • セッションを切断し、USBデバイスを挿入し、セッションに再接続します。

  • USBデバイスを抜き、再度差し込みます。この操作により、デバイスが低電力モードから復帰します。

• 場合によっては、バッテリー寿命を最適化するためにUSBバッテリーセーバー設定が有効になっていることがあります。クライアントエンドポイントがスリープ状態になると、USBデバイスが切断されることがあります。このような状況では、セッションでデバイスを再度表示するために、デバイスを切断して再接続する必要がある場合があります。

イベントログ

管理者は、ユーザーがリダイレクトしようとする不正なデバイスを監視し、適切な措置を講じることができます。以下に、リダイレクトが許可されているデバイスと許可されていないデバイスについて、VDAホストのイベントビューアーに記録されるイベントメッセージの一部を示します。