> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/ja/naentpuraizusbisu/virtual-desktop-infrastructure/vdi-explainer/troubleshooting.md).

# トラブルシューティング

<mark style="color:青;">**Zoom Workplace VDI アプリとプラグインからログを生成して収集する方法**</mark>

VDI ホスト インストーラーには、診断調査のために Zoomサポート へ転送するログを、ユーザーが簡単に生成および収集できるログ収集ツールが付属しています。これらのログは、Zoom Workplace VDI アプリに関連する特定の問題のトラブルシューティングに使用できますが、必要な場合にのみ使用してください。

{% hint style="warning" %}
**注意**

次を使用します **LogLevel** ログを有効にする前に正しいレベルを設定するためのポリシーです。デフォルトは「0」で、これによりログ記録は無効になります。ほとんどのトラブルシューティングでは、最大量のログデータを提供するために LogLevel を「4」に設定する必要があります。

トラブルシューティング用のログは必要な場合にのみ収集し、使用のたびにログ記録ツールが無効になっていることを確認してください—**しないでください** 監視されていない間、ログ記録機能を有効のままにしないでください。
{% endhint %}

ログ収集ツールにアクセスするには、アプリケーションがインストールされているディレクトリを開きます — デフォルトでは C:\Program Files(x86)\Zoom VDI\Bin です — そのフォルダー内で次を探します **ZoomVDITool.exe** そのフォルダー内のファイル。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfsmH3aZPGNp7RfTCb68JmfmK4K1XWj2WPDo7H4k8uGXNjsaz4ei1JJmPFngYF8F3k-JZrPXqOU6Z5POHcCC9xA0s91xRxvBMWjVAEXY-ZLzJY6YwfP-Ny1B7E-4jaSjE5RsXYp?key=Y8FtDbpjXDezi-KeGzQVkA" alt="" width="563"><figcaption><p>Zoom VDI ログ記録ツールを示す画像</p></figcaption></figure></div>

ログ収集ツールを使用するには、まずログの保存先の位置情報を選択します。次に、保存位置情報の下にあるボックスをクリックしてログ記録を有効にするには設定します。その後、Zoom Workplace VDI アプリを再起動し、問題を再現して、 **ログを収集** VDI ツールを使用して。収集後、ログは指定したディレクトリ内のファイルで利用可能になり、さらなるトラブルシューティングのために Zoomサポート へ送信できます。

{% hint style="warning" %}
**注意**

ログ記録を有効にすると、ログを生成するための CPU 使用率とディスク アクセスが増加します。
{% endhint %}

<mark style="color:青;">**HID ミュート ボタンは Zoom Workplace VDI アプリと同期していません**</mark>

HID 対応ヘッドセットを使用している場合、通常はオーディオ同期のために HID コマンドが自動的に Zoom に送信されます。ただし、Cisco Webex や Microsoft Teams など、HID コマンドを利用する別のアプリケーションが Zoom Workplace アプリより先に起動し、HID 機能の制御を取得した場合、Zoom での HID サポートは利用できない可能性があります。

<mark style="color:青;">**高度なプラグインのトラブルシューティング**</mark>

以下のセクションでは、VDI プラグインの起動時またはインストール時によく報告される問題を扱います。推奨されるトラブルシューティングで問題が解決しない場合は、追加の支援のために Zoomサポート を連絡先としてください。

<mark style="color:青;">**Citrix Receiver/Omnissa Horizon client が実行中です。Citrix Receiver 用 Zoom プラグインのインストールを続行するには、これを閉じてください。**</mark>

<div data-with-frame="true"><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfexwyfuSSbnPKb8veeAROL055xr7eeVy3uoIf96C2CofMdeVG6-Cn-gm80fWtE9oBZtBaRzZe2R0N7jmN-YvJn3g1vdbnBbI7-jjjwPbx3Fx1jDriQjb8SApRfJlXb4JN8WAgBCfNAraLkIeExisNuhw?key=Y8FtDbpjXDezi-KeGzQVkA" alt="" width="375"></div>

このエラーは、インストール処理中に Citrix ワークスペース または Omnissa Horizon Client がまだ実行中の場合に発生することがあります。いずれかのプロセスに開いているウィンドウがある場合は、それらを閉じてインストールを再開してください。プロセスが応答しない場合は、タスク マネージャーを使用してプロセス（wfica32.exe または omnissa-view\.exe）を終了するか、管理者として実行したコマンド プロンプトから次を実行できます:

```
//taskkill /im wfica32.exe /f
//taskkill /im omnissa-view.exe /f
```

<mark style="color:青;">**新しいバージョンの製品がすでにインストールされているため、インストールできません**</mark>

<div data-with-frame="true"><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfexwyfuSSbnPKb8veeAROL055xr7eeVy3uoIf96C2CofMdeVG6-Cn-gm80fWtE9oBZtBaRzZe2R0N7jmN-YvJn3g1vdbnBbI7-jjjwPbx3Fx1jDriQjb8SApRfJlXb4JN8WAgBCfNAraLkIeExisNuhw?key=Y8FtDbpjXDezi-KeGzQVkA" alt="" width="375"></div>

このエラーは、現在のプラグインのバージョンが、インストールしようとしているプラグインのバージョンを上回っている場合に発生します。解決するには、現在インストールされているプラグインのバージョンが、インストールしようとしているものより新しいかどうかを確認してください。確認できた場合は、既存のプラグインをアンインストールし、失敗したインストール パッケージを再試行してください。

<mark style="color:青;">**ファイルのコピー中にエラーが発生し、インストールを完了できませんでした**</mark>

<div data-with-frame="true"><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd-kV2JuFlwJo28UdPOesQsI1uUe9J9phaCmFrw5gBErZdVqIJ8LjqbeXbsIezerh1_ERYCtkW6NTPQyRFXv29UMbB80XkYfGMilXbBSmuwm9lqxBTs-7CwBZvSvN2y_E3QrjJp-yKttBwAstENawV-PIs?key=Y8FtDbpjXDezi-KeGzQVkA" alt="" width="375"></div>

このエラーは、インストーラーがファイルをディレクトリにコピーできない場合によく発生しますが、仮想デスクトップ エージェントの通常とは異なるレジストリ キーの場所が原因となることもあります。このエラーが発生した場合は、支援のために Zoomサポート を連絡先としてください。

<mark style="color:青;">**Citrix ライトモード**</mark>

Citrix では、ユーザーは「ライトモード」で仮想デスクトップまたはプログラムを起動できます。このモードでは、完全な Citrix クライアントではなく、仮想アプリケーションがブラウザで起動します。ライトモードは、メディア最適化に必要な仮想チャネルをサポートしておらず、フォールバック モードでの体験になります。仮想デスクトップから VDI プラグインにオーディオとビデオをオフロードするには、Citrix アプリケーションを通じて仮想デスクトップに接続する必要があります。

<mark style="color:青;">**仮想チャネル許可リスト**</mark>

Citrix リリース 2109 以降、仮想チャネル許可リストのポリシーはデフォルトで有効になりました。Zoom Workplace VDI アプリが VDI プラグインに接続されておらず、Citrix 環境が最近この新しいリリースにアップグレードされた場合は、仮想チャネル許可リストのポリシーを編集する必要がある可能性があります。次の記事を参照してください [Zoom 向け Citrix 仮想チャネル許可リスト ポリシーの設定](https://support.zoom.us/hc/en-us/articles/4412351225101)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://library.zoom.com/technical-library/ja/naentpuraizusbisu/virtual-desktop-infrastructure/vdi-explainer/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
