警报 签署了
联络支持

看过本文的客户也进行了浏览

横幅
CTX209255 {{tooltipText}}

VDA清理工具

下载VDACleanupUtility.zip为什么我不能下载这个文件? 登录验证下载权限VDACleanupUtility.zip

适用的产品

  • Citrix虚拟应用和桌面
  • XenDesktop

Citrix虚拟应用程序和桌面,前身为XenApp和XenDesktop,适合将VDI和应用程序带入以用户为中心的体验的企业需求。

VDA Cleanup Utility v1.7.0.9

创建日期:2016年4月4日

更新日期:2021年3月12日

请反馈给https://podio.com/webforms/15459646/1036539来帮助我们改进这个工具。

描述

VDA清理工具可以帮助解决以下场景:

  • 当从较早版本的VDA升级过程中发生错误时
  • 当从较早的VDA升级后出现意外行为或性能时
  • 如果由于特性不兼容而无法升级VDA,则需要彻底卸载
  • VDA清理实用程序删除VDA 5.6及以上版本的组件、文件和注册表值

重要的笔记

为所有用户:

  1. 当去掉一个7。在VDA中,该工具可能需要20分钟才能完成,并且在此期间似乎没有响应。为防止系统变得不稳定或不可用,请不要终止或重新启动该工具。相反,允许工具自己完成删除过程,然后在提示时重新启动系统。
  2. 此版本的工具目前不支持Windows 8.1。

v1.7.0.9有什么新功能

  • 增加了对VDA 1912清理的支持。
  • 增加了工具的最新版本验证功能。
  • 修正了导致VDA清理工具错误删除Citrix HDX RealTime连接器的问题。

以前版本的更改

  • 增加了卸载浏览器内容重定向msi (BCR_x64.msi)的帮助。
  • 增加了移除残留的VDA注册表项和文件的支持,阻止从Windows 7升级到Windows 10。
  • 在Windows 2016上增加了VDA清理的支持。
  • 增加了对自定义日志路径的支持。
  • 增加了通过TLS 1.2/TLS 1.1上传经验指标的支持。
  • 增加了对删除阻止在某些平台上安装新的VDA的残留注册表项的支持。
  • 支持无人参与模式
  • 改进的错误处理。
  • 改进的日志记录。
  • 解决了在操作系统挂起重启时阻止工具正常工作的问题。
  • 引入了命令行参数“/DISABLEEXPERIENCEMETRICS”,防止在删除过程中收集的分析数据自动上传。
  • 改进了驱动程序移除。
  • 减少了VDA版本7.7到7.11在Windows 2012 R2或Windows 10操作系统上的卸载时间。
  • 更改为在VDA卸载期间不清除AppInit DLL注册表值
  • 将卸载日志文件从纯文本。log转换为。xml文件格式
  • 解决了重新安装后可能导致VDA注册失败的情况
  • 防止运行导致键盘和鼠标故障的工具的多个实例
  • 改进了工具处理损坏的msi和注册表项的能力。

支持操作系统

支持的服务器操作系统版本

  • Windows 2019
  • Windows 2016
  • Windows 2012 R2
  • Windows 2008 R2 Sp1

支持的桌面操作系统版本(32位和64位除外):

  • Windows 10 *
  • Windows 7

*对于Windows 10机器,支持以下服务选项和版本:

  • 目前业务分支:教授,企业,教育
  • 长期服务分部:LTSB
  • Current Branch (CB):不支持

先决条件

要运行该工具,您必须在目标计算机上拥有管理员权限。

必要的安全权限

具有读、写、修改权限的用户如下:

  • 本地机器注册表(HKLM)
  • 本地用户注册处(香港大学)
  • 计算机上的默认用户配置文件
  • %ProgramFiles%\Citrix(32位系统)或%ProgramFiles(x86)%\Citrix(64位系统)

备份注册表

看到微软的文章如何备份和恢复注册表在Windows有关备份注册表的说明。

如何使用VDA清理工具

VDA清理工具是一个独立的可执行文件,不需要安装。

虽然VDA清理工具在删除VDA注册表项之前会备份它们,但Citrix建议您在运行此工具之前备份注册表项。看到微软的文章如何备份和恢复注册表在Windows有关备份注册表的信息。

注意:总是备份注册表。

步骤:

  • 使用管理员权限运行VDA清理实用程序。
  • 该工具可能提示重新启动系统以完成驱动程序删除。
  • 系统重新启动后,使用相同的管理员帐号登录机器,工具自动重新运行。

注意:

  • 您可以使用/silent选项在静默模式下运行VDA清理工具。

C: / > VDACleanupUtility.exe /沉默

静默模式下,工具会自动重启系统。使用相同的管理员帐户登录到计算机。该工具会自动重新运行。

  • 可以通过“/NoReboot”选项抑制系统自动重启。但是,Citrix建议您在尝试重新安装VDA之前重新启动计算机。

C: / > VDACleanupUtility.exe /无人值守

  • 您可以使用/unattend选项在无人值守模式下运行VDA清理实用程序。在无人参与模式下,实用程序在没有任何提示的情况下卸载VDA,并抑制系统重启。根据退出码(1或0),您可能需要或不需要手动重启系统:

退出码1:手动重启系统,重新执行命令。

退出码0:VDA清理完成。

VDA清理工具的日志文件是在%TEMP%\Citrix\VdaCleanup中创建的文件夹,并可用于跟踪所有卸载操作和结果。

如何使用SCCM任务序列运行VDA清理工具

看到如何使用SCCM任务序列运行VDA清理实用程序

VDA清理工具修改的数据

在使用标准的metainstaller卸载进程之后,该实用程序将终止所有正在运行的VDA进程(如果有的话)。请参阅工具附带的Readme文件,了解在清理过程中删除的项目列表。

如何撤消由VDA清理实用程序所做的更改

VDA清理工具在%TEMP%\Citrix\VdaCleanup\RegBackup中创建与VDA相关的Citrix注册表项的备份。在运行任何清理和删除过程之前注册文件。

撤销更改:

  • 重新安装这两
  • 导入RegBackup。Reg文件以恢复注册表中的设置和自定义

卸载VDA清理工具

从当前文件夹中删除下载的可执行文件,并从%TEMP%\Citrix\VdaCleanup文件夹中删除日志文件。

已知的问题

故障类型 描述 可能的纠正措施
卸载 如果VDA没有安装在默认位置,VDA清理实用程序可能无法正常工作。 这是该工具当前版本的一个已知问题,将在未来的版本中解决。
安装 降级到较早版本的VDA可能会导致重新安装错误。原因是VDA清理工具没有删除VDA所需的Microsoft Visual c++运行时。Microsoft Visual c++运行时可以根据所安装的VDA版本而有所不同。 在重新安装较早版本的VDA之前,请先手动卸载较早版本的Microsoft Visual c++ runtime。请参阅VDA先决条件来确定Microsoft Visual c++运行时所需的版本。
安装 降级到较早版本的VDA可能会导致重新安装错误。原因是VDA清理工具没有删除VDA所需的Microsoft . net框架。Microsoft . net Framework可以根据所安装的VDA版本而有所不同。 在重新安装较早版本的VDA之前,请手动卸载较早版本的Microsoft . net Framework。请参阅VDA先决条件以确定Microsoft . net Framework所需的版本。
登记 当使用程序和功能或VDA清理工具手动删除VDA时,不会删除C:\ProgramData\Citrix\PvsAgent文件夹。因此,如果将VDA移到另一个站点(从站点1移到站点2),VDA可能无法注册。 请按照Citrix产品文档页面。
卸载 在实用程序启动重新启动后,试图以不同的用户登录到启用了AutoAdminLogon的Desktop VDA,可能会导致VDA不能被正确删除。 在尝试以不同用户登录之前,允许删除过程完成。
卸载 使用启用了AutoAdminLogon的服务器VDA允许多个会话登录,在实用程序启动重新启动后,可能会导致VDA不能被正确删除。 在允许多个会话登录之前,允许删除过程完成。
卸载

当工具提示时没有重新启动操作系统可能导致VDA不能被正确删除。此外,未来尝试重新安装相同或更高版本的VDA而不重新启动,可能会导致安装错误。

当提示时,按照实用程序的建议重新启动VDA。
卸载
当您在安装了交付控制器的机器上安装Windows VDA时,运行VDA清理实用程序将删除以下注册表项。因此,Citrix Studio只显示自动站点升级选项,而不是常规的控制台。单击升级按钮后,出现以下错误信息:
您没有完成此请求所需的权限
  • HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Citrix桌面交付控制器
  • HKEY_LOCAL_MACHINE \ Citrix \ \软件配置
  • HKEY_LOCAL_MACHINE \ \ Citrix \ DesktopServer软件
在卸载VDA后,使用VDA清理工具备份注册表项并手动恢复它们。

联系信息
问题吗?担忧吗?发送任何反馈到https://podio.com/webforms/15459646/1036539

免责声明

这些软件应用程序是按原样提供给您的,没有任何形式的声明、保证或条件。您可以自行承担使用和分发的风险。思杰不承担任何明示、默示、书面、口头或法定的保证,包括但不限于适销性、适用于特定目的、所有权和非侵权的保证。在不限制上述规定的通用性的情况下,您承认并同意:(a)软件应用程序可能出现错误、设计缺陷或其他问题,可能导致数据丢失或财产损坏;(b)可能无法使该软件应用程序充分发挥功能;以及(c) Citrix可以在不向您发出通知或承担责任的情况下停止提供该软件应用程序的当前版本和/或任何未来版本。在任何情况下,本准则都不应用于支持超危险活动,包括但不限于生命维持或爆破活动。CITRIX和其附属公司或代理人将承担责任,根据违反合同或任何其他责任理论,对任何损害赔偿因使用软件应用程序,包括但不限于直接的、特殊的、附带的、惩罚性的、间接的或其他损失,即使告知此类损害的可能性。您同意对因您使用、修改或分发代码而引起的任何及所有索赔作出赔偿并为思杰辩护。