Citrix Virtual Apps and Desktops

故障排除

May 31, 2026

投稿者:

排查与已发布应用程序相关的会话注销问题

发布应用程序时，仅指定已发布应用程序的主可执行文件。但是，某些应用程序可能会生成在后台运行的额外（子）进程，并且在主已发布应用程序关闭时，这些进程不会随相应的主可执行文件一起关闭。额外进程也可能由执行的脚本或特定的注册表项（例如 Run 和 RunOnceKey）创建。这些应用程序可能会阻止正常注销，导致会话残留或挂起，并可能导致会话无法关闭且用户无法注销。

在这种情况下，您需要使用 Citrix Director 重置或退出这些会话。

为了帮助识别和排查会话无法正常注销的问题，Citrix 提供了三个注册表项。识别和排查由于这些问题导致会话无法正常注销是一个三步过程：

识别哪些会话因运行已发布应用程序而阻碍正常注销
识别这些已发布应用程序是否生成任何额外（子）进程
将这些进程添加到指定的注册表项以防止它们阻止注销

步骤 2：识别这些已发布应用程序是否生成任何额外（子）进程

一旦确定某个已发布应用程序正在阻止正常注销，下一步是确定此应用程序在运行时是否生成额外进程。

您可以阅读 HKCU\Software\CitrixVolatile\Seamless\Sessions\[ID]\LogoffCheckerBlockingProcess 以确定当已发布应用程序关闭时是否有任何进程正在阻止正常注销。

在以下示例中，密钥 LogoffCheckerBlockingProcess 包含以下条目：

PhoneExperienceHost.exe
SkypeApp.exe
SkypeBackgroundHost.exe
<!--NeedCopy-->

这些进程阻碍了正常注销的顺利进行。

注意：

将 [ID] 替换为您要检查的会话的正确会话 ID。

步骤 3：将这些进程添加到指定的注册表项，以防止它们阻止注销

您可以将这些进程添加到以下注册表项，以防止它们在将来的会话中阻止注销：

Add the process file name to the following registry key:
Caution! Refer to the Disclaimer at the end of this article before using the Registry Editor.
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI
Value Name:LogoffCheckSysModules
Type:REG_SZ
String:MyAppName.exe
<!--NeedCopy-->

有关 LogoffCheckSysModules 的更多信息，请参阅从已发布的应用程序正常注销导致会话处于活动状态。

逐步疑难解答指导手册

在受测 VDA 下启动远程注册表服务：
1. 在“控制面板”中，选择 “管理工具”>“服务”。
2. 右键单击 “远程注册表服务”，然后选择 “属性”。
3. 在 “启动类型” 下，从下拉菜单中选择 “自动”。
关闭受测 VDA 上的 Windows 防火墙，或创建入站防火墙规则以启用端口 455：
1. 在“控制面板”中，选择 “Windows Defender 防火墙”>“高级设置”。
2. 右键单击 “入站规则”，然后选择 “新建规则”。
3. 在 “新建入站规则向导” 中，选择 “端口”。
4. 在 “协议和端口” 页面上，选择 “TCP 和特定本地端口”。输入 445 作为本地端口。
5. 在 “操作” 页面上，选择 “允许连接”。
6. 选择要应用新入站规则的防火墙配置文件。
7. 命名防火墙规则，然后选择完成以退出 新建入站规则向导。
  
  已发布的应用程序防火墙端口(/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/media/published-app-firewall-port.png)
从同一域中的另一台 VM（可以是 DC、DDC 或另一台 VDA）运行 Regedit 并连接到远程注册表。

已发布的应用程序注册表编辑器(/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/media/published-app-registry-editor.png)
输入受测 VDA 的 IP 地址，然后单击确定。regedit 树必须显示受测 VDA 的分支。

已发布的应用程序 regedit(/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/media/published-app-regedit.png)
打开 命令提示符 已发布的应用程序。

已发布的应用程序管理(/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/media/published-app-manage.png)

命令提示符 应用程序显示在 Citrix Workspace 上。

已发布的应用程序命令提示符(/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/media/published-app-cmd-prompt.png)
在客户端上打开 连接中心。这用于在关闭已打开的无缝应用程序后，监视会话何时注销。我们可以从下图中看到，命令提示符进程 c:\Windows\system32\cmd.exe 在远程 VDI 上处于活动状态。

已发布的应用程序连接(/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/media/published-app-citrix-workspace-connection-center.png)
从运行 regedit 的 VDA，转到以下远程 IP 位置： HKEY_USERS\S-1-X-XX-XXXXXXXX-XXXXXXXXXXX-XXXXXXXXXX-XXXX\SOFTWARE\CitrixVolatile\Seamless\Sessions\X\

注意：

此路径在每次打开新会话时都会更改。
此处有两个要读取的键（请勿在此处更改它们）：LogoffCheckBlockingProcess 和 LogoffCheckerBlockingVisibleProcess。这些键显示任何阻止注销的程序。第一个必须显示 C:\Windows\System32\cmd.exe，因为它已打开但尚未关闭。

注意：

LogoffCheckBlockingProcess and LogoffCheckerBlockingVisibleProcess must not be manually edited. Manually editing these registry values could lead to unstable sessions.
单击右上角的 X 以退出 Seamless CMD。
检查连接中心以查看会话是否关闭。关闭可能需要长达 30 秒。如果会话关闭，则表示没有应用程序或进程阻止正常注销。
如果会话未关闭，请按 F5 刷新 regedit 输出。
再次检查 LogoffCheckBlockingProcess 和 LogoffCheckerBlockingVisibleProcess 的内容。CMD 不应再出现，但应该有另一个列出的进程。当前阻止会话注销的任何进程都必须在此处显示。

在这种情况下，在命令提示符关闭之前，Notepad.exe 从已发布的命令提示符中打开，并且此远程记事本进程正在阻止正常注销。
记下此可执行文件的路径以及它出现在哪个键中，并将其输入到远程树下的以下注册表项中：
- If it appears in LogoffCheckBlockingProcess: HKLM\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWILogoffCheckSysModulesInternal
- If it appears in LogoffCheckerBlockingVisibleProcess: HKLM\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWILogoffCheckVisibleSysModules
注意：

如果键中已有一个或多个条目，请在末尾添加逗号，并将新条目放在逗号后面。
从客户端上的连接中心注销会话，然后重新打开远程应用程序。
重复步骤 9-16，直到在关闭远程应用程序后的 30 秒内自动注销会话。

注意：

故障排除后，如果需要，请恢复临时防火墙更改以允许远程注册表访问。