> 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/zh/gao-ji-qi-ye-fu-wu/vdi/troubleshooting.md).

# 故障排除

本节提供有关排查 Zoom Workplace VDI 应用常见问题的指导。

<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 的耳机，它应会自动向 Zoom 发送 HID 命令以同步音频。不过，如果在 Zoom Workplace 应用启动前，另一个使用 HID 命令的应用程序（例如 Cisco Webex 或 Microsoft Teams）已启动并接管了 HID 功能，那么 Zoom 中的 HID 支持可能无法使用。

<mark style="color:蓝色;">**高级插件故障排查**</mark>

以下部分介绍启动或安装 VDI 插件时常见的问题。如果按照建议进行故障排查后问题仍未解决，请联系 Zoom 支持以获取更多帮助。

<mark style="color:蓝色;">**Citrix Receiver/Omnissa Horizon 客户端正在运行。请将其关闭，然后继续安装适用于 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 客户端在安装过程中仍在运行，可能会出现此错误。如果任一进程有打开的窗口，请关闭这些窗口并继续安装。如果进程卡住，可以使用任务管理器终止该进程（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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/zh/gao-ji-qi-ye-fu-wu/vdi/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
