安装和卸载

您可以从 Citrix 的下载页面或公司下载页面（如果可用）下载 Citrix Workspace 应用程序。

您可以通过以下方式安装该软件包：

• 运行交互式基于 Windows 的安装向导。

  或者

• 键入安装程序文件名、安装命令和安装属性，使用命令行界面。有关使用命令行界面安装 Citrix Workspace 应用程序的信息，请参阅使用命令行参数。

注意：

• 请验证是否已安装所有必需的系统要求，如系统要求部分所述。

• 升级到更高版本的 Citrix Workspace 应用程序时，请使用 CitrixWorkspaceApp.exe /CleanInstall 命令。对于降级，建议先卸载 Citrix Workspace 应用程序。

使用管理员和非管理员权限进行安装：

用户和管理员都可以安装 Citrix Workspace 应用程序。仅在使用直通身份验证、单点登录、应用程序保护和Microsoft Teams VDI 插件与适用于 Windows 的 Citrix Workspace 应用程序结合使用时才需要管理员权限。

下表介绍了以管理员或用户身份安装 Citrix Workspace 应用程序时的区别：

注意：

管理员可以覆盖用户安装的 Citrix Workspace 应用程序实例，并成功继续安装。

• 清理和安装 Citrix Workspace 应用程序的命令

使用 /CleanInstall 命令清理以前卸载后留下的任何痕迹（例如文件和注册表值），然后全新安装新版本的 Citrix Workspace 应用程序。

例如：

CitrixWorkspaceApp.exe /CleanInstall
<!--NeedCopy-->

注意：

forceinstall 和 cleaninstall 命令之间的区别在于，forceinstall 在版本升级不受支持或出现任何故障时运行，而 cleaninstall 始终在执行所需操作（无论是安装还是升级）之前进行清理。

适用于具有应用程序保护功能的 Citrix Workspace™ 应用程序的增强安装过程

以前，当启用应用程序保护时，不支持 /cleanInstall 开关，用户必须手动卸载并重新启动计算机，然后才能重试安装。从 2503 版本开始，当启用应用程序保护并运行 /CleanInstall 命令时，Citrix Workspace 应用程序会自动卸载，根据用户选择重新启动计算机，并在重新启动期间重新安装应用程序。在此过程中会显示以下消息：

  -  ![安装成功](/en-us/citrix-workspace-app-for-windows/media/installation-successful.png)

• 如果用户单击重新启动，Citrix Workspace 应用程序将在重新启动期间重新安装。
• 如果用户单击取消，Citrix Workspace 应用程序将在下次重新启动时安装。因此，在系统中搜索应用程序时，Citrix Workspace 应用程序将不可用。

注意：

 -  对于静默安装，Citrix Workspace 应用程序仅在下次用户启动的重新启动后才可用。
 -  如果用户在重新启动之前重试安装，将显示以下提示以重新启动系统：

基于用户界面的安装

您可以通过手动运行 CitrixWorkspaceApp.exe 安装程序包来安装适用于 Windows 的 Citrix Workspace 应用程序。

1. 启动 CitrixWorkspaceApp.exe 文件。

   • 系统会验证 Citrix Workspace 应用程序所需的先决条件，如果需要，会自动安装。

   • 

   安装先决条件后，将显示欢迎使用 Citrix Workspace 安装程序屏幕。

2. 单击继续。将显示Citrix 许可协议页面。

   • 1. 阅读并接受 Citrix 许可协议，然后继续安装。Citrix Workspace 应用程序安装将继续并成功完成。

• 1. 使用管理员权限安装时，您可以从附加组件页面中选择以下选项：
  • 安装后启动应用程序保护
  • 启用单点登录
  • 安装 Microsoft Teams VDI 插件
  • 安装 Zoom VDI 插件
  • 安装 Cisco WebEx VDI 插件

  

  Citrix Workspace 应用程序安装将继续并成功完成。

重要提示：

从 Citrix Workspace app for Windows 2311.1 版本开始，TrolleyExpress 已替换为 CWAInstaller-<date and timestamp>。例如，日志记录在 C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441。

• 使用 Windows 应用商店

1. 导航到 Microsoft Store。
2. 搜索 Citrix Workspace。

1. 单击“获取”。Citrix Workspace app 将安装。

基于命令行的安装

您可以通过指定不同的命令行选项来自定义 Citrix Workspace app 安装程序。安装程序包在启动安装程序之前会自解压到系统临时目录。空间要求包括启动多个应用程序后的程序文件、用户数据和临时目录。

• 要使用 Windows 命令行安装 Citrix Workspace app，请启动命令提示符并在单行中键入以下内容：

• 安装程序文件名，
• 安装命令，以及
• 安装属性

可用的安装命令和属性如下：

• CitrixWorkspaceApp.exe [commands] [properties]

命令行参数列表

参数大致分类如下：

• 通用参数
• 更新参数
• 安装参数
• HDX 功能参数
• 首选项和用户界面参数
• 身份验证参数

通用参数

注意：

• forceinstall 开关是 rcu 开关的替代项。rcu 开关自版本 1909 起已弃用。有关详细信息，请参阅弃用。

forceinstall 和 cleaninstall 命令之间的区别在于，forceinstall 在不受支持的版本升级或任何故障的情况下运行，而 cleaninstall 始终在执行所需操作（无论是安装还是升级）之前进行清理。

自动更新参数

检测可用更新

• 命令：AutoUpdateCheck
• 说明：此命令指示 Citrix Workspace app 在有可用更新时进行检测。

可能的值如下：

注意：

AutoUpdateCheck 是一个强制参数，您必须设置它才能配置其他参数，例如 AutoUpdateStream、DeferUpdateCount、AURolloutPriority。

选择要更新的版本

• 命令：AutoUpdateStream
• 说明：如果已启用自动更新，则可以选择要更新的版本。有关详细信息，请参阅生命周期里程碑。

可能的值如下：

推迟更新通知

• 命令：DeferUpdateCount
• 说明：指示在有可用更新时可以推迟通知的次数。有关详细信息，请参阅 Citrix Workspace 更新。

可能的值如下：

注意：

• 从适用于 Windows 的 Citrix Workspace 应用程序版本 2207 开始，自动更新功能得到改进，并且 DeferUpdatCount 参数不适用。

• 设置推出优先级

• 命令：AURolloutPriority
• 描述：当应用程序的新版本可用时，Citrix 会在特定交付期内推出更新。使用此参数，您可以控制在交付期内的何时接收更新。

可用值如下：

• Fast	您将在交付期开始时接收更新。	CitrixWorkspaceApp.exe AURolloutPriority=Fast
  Medium	您将在交付期中期接收更新。	CitrixWorkspaceApp.exe AURolloutPriority=Medium

• Slow

  您将在交付期结束时接收更新。

  CitrixWorkspaceApp.exe AURolloutPriority=Slow

应用商店配置参数

• 配置应用商店

• 命令：ALLOWADDSTORE
• 描述：允许您根据指定参数配置应用商店（HTTP 或 HTTPS）。

可用值如下：

• |ALLOWADDSTORE 命令值|描述|示例| |—|—|—|

• S（默认）

  仅允许添加或删除安全应用商店（通过 HTTPS 配置）。

  CitrixWorkspaceApp.exe ALLOWADDSTORE=S

• A

  允许添加或删除安全应用商店 (HTTPS) 和非安全应用商店 (HTTP)。如果 Citrix Workspace 应用程序是按用户安装的，则不适用。

  CitrixWorkspaceApp.exe ALLOWADDSTORE=A

• N

  绝不允许用户添加或删除自己的应用商店。

  CitrixWorkspaceApp.exe ALLOWADDSTORE=N

在本地保存应用商店凭据

• 命令：ALLOWSAVEPWD
• 描述：允许您在本地保存应用商店凭据。此参数仅适用于使用 Citrix Workspace 应用程序协议的应用商店。

可用值如下：

使用命令行安装配置应用商店的示例

指定 StoreFront 应用商店 URL：

CitrixWorkspaceApp.exe /silent
STORE0="AppStore;https://testserver.net/Citrix/MyStore/discovery;on;HR App Store"

<!--NeedCopy-->

指定 Citrix Gateway 应用商店 URL：

CitrixWorkspaceApp.exe STORE0=HRStore;https://ag.mycompany.com#Storename;On;Store
<!--NeedCopy-->

其中，Storename 指示需要配置的应用商店的名称。

注意：

• 使用此方法配置的 Citrix Gateway 应用商店 URL 不支持使用 Citrix Gateway 的 PNA Services 站点。
• 指定 Citrix Gateway 应用商店 URL 时，不需要“Discovery”参数。

配置多个应用商店：

CitrixWorkspaceApp.exe  STORE0="StoreFront Store;https://testserver.net/Citrix/MyBackupStore/discovery;on; StoreFrontStore"

STORE1="NetScaler Store;https://ag.mycompany.com#Storename;On;NetScaler Store"
<!--NeedCopy-->

注意：

必须在应用商店 URL 中包含 discovery，以实现成功的直通身份验证。

下表提供了应用商店 URL 参数的描述：

• 参数	描述
  应用商店名称	用户看到的该应用商店的名称。

• 应用商店 URL

  该应用商店的 URL。

• 应用商店启用状态	状态可以是“开”或“关”。
  应用商店描述	用户看到的该应用商店的描述。

StoreFront™ 示例：

SalesStore;https://sales.mycompany.com/Citrix/Store/discovery;On;Store 适用于销售人员。

安装参数

启动应用程序保护

• 命令：startAppProtection
• 描述：启动应用程序保护组件，并通过限制客户端受到键盘记录和屏幕捕获恶意软件攻击的能力来提供增强的安全性。
• 示例：CitrixWorkspaceApp.exe startAppProtection

有关详细信息，请参阅应用程序保护文档。

注意：

• startAppProtection 开关是 includeAppProtection 开关的替代项。includeAppProtection 开关自版本 2212 起已弃用。有关详细信息，请参阅弃用。

排除 Citrix Enterprise Browser 二进制文件

• 命令：运行以下命令以排除 Citrix Enterprise Browser™

CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper
<!--NeedCopy-->

• 说明：排除 Citrix Enterprise Browser 二进制文件。

您只能在以下情况下排除 Citrix Enterprise Browser 二进制文件：

• 全新安装

• 从不包含 Citrix Enterprise Browser 二进制文件的版本升级。

• 排除 EPA 客户端的自动安装

• 命令：CitrixWorkspaceApp.exe InstallEPAClient=N
• 说明：停止自动安装 EPA 客户端。
• 例如，使用以下命令

CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper InstallEPAClient=N
<!--NeedCopy-->

您可以在以下情况下排除 EPA：

• 全新安装
• 从不包含 EPA 的版本升级。

指定自定义安装目录

• 命令： INSTALLDIR
• 说明：指定 Citrix Workspace 应用程序安装的自定义安装目录。默认路径为 C:\Program Files\Citrix。
• 示例：CitrixWorkspaceApp.exe INSTALLDIR=C:\custom path\Citrix。

注意：

Program Files 文件夹受操作系统保护。如果要使用 Program Files 以外的自定义文件夹，请确保该文件夹具有正确的权限并受到保护。

• 安装一个或多个特定组件

• 命令：ADDLOCAL
• 说明：使用 ADDLOCAL 密钥安装 Citrix Workspace 应用程序的一个或多个特定组件。使用此密钥，如果您安装任何特定组件，Citrix Workspace 应用程序将默认安装所有强制组件。

注意：

• 升级 Citrix Workspace 应用程序时，安装程序不会遵守针对基本版本中已存在的组件的排除命令（例如 BCR_Client）。要在升级过程中删除组件，请在安装具有所需排除参数的新版本之前，完全卸载现有 Citrix Workspace 应用程序。

我们建议您仅在要安装 Citrix Workspace 应用程序的任何特定组件时使用 ADDLOCAL 密钥。默认情况下，如果未指定 ADDLOCAL 参数，则在安装 Citrix Workspace 应用程序时会安装所有受支持的组件。

下表列出了 ADDLOCAL 密钥支持的组件：

• BCR_Client

  BCR 客户端

  用于处理浏览器内容重定向的插件。

• USB	USB 客户端	用于处理 USB 重定向的插件。
  DesktopViewer	Desktop Viewer 客户端	虚拟桌面的 UI 框架。
  AM	AuthManager	身份验证管理器 - 授权用户访问 Citrix Workspace 应用程序。
  SSON	SSON	单点登录组件 – 支持单点登录。
  SELFSERVICE	自助服务	用于 Citrix Workspace 本机启动的插件。
  WebHelper	Web Helper	用于将浏览器与本机 Workspace 应用程序连接的帮助程序。
  CitrixEnterpriseBrowser	浏览器	本机浏览器，使用户能够以安全方式从 Citrix Workspace 应用程序打开 Web 或 SaaS 应用程序。

• 例如，使用以下命令，您可以安装命令中提到的组件：

CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper,CitrixEnterpriseBrowser
<!--NeedCopy-->

注意：

• 从版本 2212 开始，默认安装应用程序保护功能。因此，AppProtection 不再是 ADDLOCAL 命令的有效选项。

• 限制：

• 当您使用 ADDLOCAL 参数安装 Citrix Workspace 应用程序时，设备和首选项窗口可能无法从连接中心响应。仅当您在没有 DesktopViewer 参数的情况下安装 Citrix Workspace 应用程序时，才会出现此问题。作为一种解决方法，请同时包含 DesktopViewer 参数。 [HDX-67173]

安装插件

• 命令：ADDONS
• 说明：使用 ADDONS 密钥安装 Citrix Workspace 应用程序的一个或多个特定插件。

下表列出了 ADDONS 密钥支持的组件：

• ADDONS 密钥

  组件名称

  说明

• |—|–|–|

• ZoomVDIPlugin	Zoom VDI 插件	作为 Citrix Workspace 应用程序安装的一部分安装 Zoom VDI 插件管理器
  WebexVDIPlugin	WebEx VDI 插件	作为 Citrix Workspace 应用程序安装的一部分安装 WebEx VDI 插件管理器

例如，使用以下命令，您可以安装命令中提到的插件：

CitrixWorkspaceapp.exe ADDONS=ZoomVDIPlugin,WebexVDIPlugin
<!--NeedCopy-->

• 安装 Citrix Casting™

重要提示：

对于 Citrix Workspace app LTSR 2402 及更高版本，即使使用 IncludeCitrixCasting 命令也无法安装 Citrix Casting。要使用此功能，您必须使用旧版 Citrix Workspace app。有关详细信息，请参阅弃用页面。

• 命令： IncludeCitrixCasting
• 说明： 在安装过程中安装 Citrix Casting。

有关 Citrix Casting 的详细信息，请参阅 Citrix Casting。

UberAgent 参数

• 命令： InstallUberAgent
• 说明： UberAgent 附加组件为 Citrix Workspace app 提供高级监视和诊断功能，可深入了解用户体验和应用程序性能。此集成仅在受管设备上可用，可简化部署并减少管理开销。

使用以下命令行安装：

使用命令 /InstallUberAgent 安装或升级 UberAgent 插件。 如果 UberAgent 已存在，请使用命令 /InstallUberAgent /SkipUberAgentUpgrade 安装插件而不升级。此选项非常适合 VDA 或 UberAgent 部署与 Citrix Workspace app 分开管理的设备。

注意：

此组件只能通过命令行安装。

• UberAgent 7.5.1 及更高版本仅支持 x64（64 位）平台。您无法在 x86（32 位）计算机上安装或使用 UberAgent。

HDX 功能参数

设置双向内容重定向

• 命令： ALLOW_BIDIRCONTENTREDIRECTION
• 说明： 指示是否启用客户端和主机之间的双向内容重定向。有关详细信息，请参阅 Citrix Virtual Apps and Desktops 文档中的双向内容重定向策略设置部分。

可能的值如下：

• 1

  指示双向内容重定向已启用。

  CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=1

• 设置本地应用程序访问

• 命令： FORCE_LAA
• 说明： 指示 Citrix Workspace app 是否随客户端本地应用程序访问组件一起安装。请以管理员权限安装 Workspace app，以便此组件正常工作。有关详细信息，请参阅 Citrix Virtual Apps and Desktops 文档中的本地应用程序访问部分。

可能的值如下：

在用户设备上设置 URL 重定向功能

• 命令： ALLOW_CLIENTHOSTEDAPPSURL

• 说明： 在用户设备上启用 URL 重定向功能。有关详细信息，请参阅 Citrix Virtual Apps and Desktops 文档中的本地应用程序访问部分。

• 可能的值如下：

• ALLOW_CLIENTHOSTEDAPPSURL 命令值	说明	示例
  0（默认）	在用户设备上禁用 URL 重定向功能。	CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=0
  1	在用户设备上启用 URL 重定向功能。	CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=1

显示文档或文件的图标

• 命令： LEGACYFTAICONS
• 说明： 指定是否显示与已订阅应用程序具有文件类型关联的文档或文件的图标。

可能的值如下：

首选项和用户界面参数

指定“开始”菜单和桌面上的快捷方式目录

注意：

使用 DESKTOPDIR 选项时，请将 PutShortcutsOnDesktop 键设置为 True。

控制对自助服务的访问

• 命令： SELFSERVICEMODE
• 说明： 控制对自助式 Citrix Workspace app 用户界面的访问。

可能的值如下：

控制会话预启动

• 命令：ENABLEPRELAUNCH
• 描述：控制会话预启动。有关详细信息，请参阅应用程序启动时间。

可能的值如下：

隐藏“快捷方式和重新连接”选项

• 命令：DisableSetting
• 描述：隐藏“快捷方式和重新连接”选项，使其不显示在“高级首选项”工作表中。有关详细信息，请参阅从“高级首选项”工作表中隐藏特定设置。

可能的值如下：

启用客户体验改善计划

• 命令：EnableCEIP
• 描述：表示您参与客户体验改善计划 (CEIP)。有关详细信息，请参阅 CEIP。

可能的值如下：

启用始终开启的跟踪

• 命令：EnableTracing
• 描述：控制“始终开启的跟踪”功能。

可能的值如下：

指定用于标识用户设备的名称

• 命令：CLIENT_NAME
• 描述：指定用于向服务器标识用户设备的名称。
• <ClientName> - 指定用于向服务器标识用户设备的名称。默认名称为 %COMPUTERNAME%。
• 示例：CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%。

将客户端名称设置为与计算机名称相同

• 命令：ENABLE_DYNAMIC_CLIENT_NAME
• 描述：允许客户端名称与计算机名称相同。更改计算机名称时，客户端名称也会随之更改。

可能的值如下：

身份验证参数

包括单点登录

• 命令：/includeSSON
• 描述：要求您以管理员身份安装。表示 Citrix Workspace 应用程序随单点登录组件一起安装。有关详细信息，请参阅域直通身份验证。
• 示例：CitrixWorkspaceApp.exe /includeSSON

从适用于 Windows 的 Citrix Workspace 应用程序版本 2503 开始，系统默认以休眠模式安装 SSON。您可以在安装后使用组策略对象 (GPO) 策略启用 SSON。要启用，请导航到“用户身份验证 > 本地用户名和密码”，然后选中“启用直通身份验证”复选框。

注意：

更新 GPO 策略后，您必须重新启动系统，SSON 设置才能生效

includeSSON 命令仅支持全新安装 Citrix Workspace 应用程序。

启用单点登录

• 命令：ENABLE_SSON
• 描述：当 Citrix Workspace 应用程序随 /includeSSON 命令一起安装时，启用单点登录。有关详细信息，请参阅域直通身份验证。

可能的值如下：

卸载 Citrix Workspace 应用程序

使用基于 Windows 的卸载程序进行卸载

您可以从控制面板卸载适用于 Windows 的 Citrix Workspace 应用程序。有关详细信息，请参阅卸载适用于 Windows 的 Citrix Workspace 应用程序部分。

注意：

在安装 Citrix Workspace 应用程序期间，系统会提示您卸载 Citrix HDX RTME 软件包。单击确定以继续卸载。

使用命令行界面进行卸载

您可以通过在命令行中键入以下命令来卸载 Citrix Workspace 应用程序：

CitrixWorkspaceApp.exe /uninstall
<!--NeedCopy-->

要静默卸载 Citrix Workspace 应用程序，请运行以下开关：

CitrixWorkspaceApp.exe /silent /uninstall
<!--NeedCopy-->

注意：

Citrix Workspace 应用程序安装程序不控制 GPO 相关的注册表项，因此它们在卸载后仍会保留。如果发现任何条目，请使用 gpedit 更新它们或手动删除它们。

故障排除

错误代码

• 有关安装程序相关的错误代码，请参阅 MsiExec.exe 和 InstMsi.exe 错误消息。
• 有关系统相关的错误代码，请参阅 系统错误代码。

安装程序日志位置

默认情况下，安装程序日志位于以下位置：

注意：

从适用于 Windows 的 Citrix Workspace 应用程序 2311.1 版本开始，TrolleyExpress 已替换为 CWAInstaller-<date and timestamp>。例如，日志记录在 C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441。

重置 Citrix Workspace 应用程序

重置 Citrix Workspace 应用程序会恢复默认设置。

重置 Citrix Workspace 应用程序时，以下项目将被重置：

• 所有已配置的帐户和应用商店。
• 自助服务插件交付的应用程序、其图标和注册表项。
• 自助服务插件创建的文件类型关联。
• 缓存文件和保存的密码。
• 每用户注册表设置。
• 每计算机安装及其注册表设置。
• 适用于 Citrix Workspace 应用程序的 Citrix Gateway 注册表设置。

从命令行界面运行以下命令以重置 Citrix Workspace 应用程序：

"C:\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\CleanUp.exe" -cleanUser
<!--NeedCopy-->

要静默重置，请使用以下命令：

"C:\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\CleanUp.exe" /silent -cleanUser
<!--NeedCopy-->

注意：

参数中使用大写 U。

重置 Citrix Workspace 应用程序不会影响以下内容：

• Citrix Workspace 应用程序或插件安装。
• 每计算机 ICA® 锁定设置。
• Citrix Workspace 应用程序的组策略对象 (GPO) 管理模板配置。