安装和卸载

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

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

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

  或

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

注意：

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

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

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

下表描述了以管理员或用户身份安装 Citrix Workspace 应用程序时的差异：

注意：

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

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

使用 /CleanInstall 命令清理之前卸载的所有剩余痕迹，例如文件和注册表值，然后全新安装新版本的 Citrix Workspace 应用程序。

例如：

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

限制：

要在启用了 App Protection 的情况下使用 /CleanInstall 命令，必须先卸载 Citrix Workspace 应用程序，重新启动计算机，然后使用 /CleanInstall 命令启动全新安装。

基于用户界面的安装

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

1. 启动 CitrixWorkspaceApp.exe 文件。

   系统会验证 Citrix Workspace 应用程序所需的必备条件，并在需要时自动安装该应用程序。

   

   安装必备组件后，将出现欢迎使用 Citrix Workspace 安装程序屏幕。

2. 单击继续。此时将出现 Citrix 许可协议页面。
3. 阅读并接受“Citrix 许可协议”并继续安装。Citrix Workspace 应用程序的安装继续进行并成功完成。

4. 使用管理员权限进行安装时，可以从加载项页面中选择以下选项：

   • 安装后启动 App Protection
   • 启用单点登录
   • 安装 Microsoft Teams VDI 插件

Citrix Workspace 应用程序的安装继续进行并成功完成。

重要：

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

使用 Windows 应用商店

1. 导航到 Microsoft 应用商店。
2. 搜索 Citrix Workspace。

1. 单击 Get（获取）。Citrix Workspace 应用程序已安装。

基于命令行的安装

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

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

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

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

CitrixWorkspaceApp.exe [commands] [properties]

命令行参数列表

参数大致分类如下：

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

常用参数

注意：

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

自动更新参数

检测可用更新

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

下面是可能的值：

注意：

AutoUpdateCheck 为必需参数，必须设置才能配置 AutoUpdateStream、DeferUpdateCount、AURolloutPriority 等其他参数。

选择要更新的版本

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

下面是可能的值：

推迟更新通知

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

下面是可能的值：

注意：

自适用于 Windows 的 Citrix Workspace 应用程序版本 2207 起，自动更新功能已得以改进，DeferUpdatCount 参数不适用。

设置推出优先级

• 命令：AURolloutPriority
• 说明：新版本的应用程序可用时，Citrix 会在特定交付期间推出更新。使用此参数，您可以控制在交付周期内的哪个时间可以接收更新。

下面是可能的值：

存储配置参数

配置应用商店

• 命令： ALLOWADDSTORE
• 说明：允许您根据指定的参数配置应用商店（HTTP 或 https）。

下面是可能的值：

将应用商店凭据保存在本地

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

下面是可能的值：

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

要指定 StoreFront 应用商店 URL，请执行以下操作：

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

<!--NeedCopy-->

要指定 Citrix Gatewaya 应用商店 URL，请执行以下操作：

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

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

注意：

• 在多应用商店设置中，只允许一种 Citrix Gateway 应用商店 URL 配置，并且该配置必须在列表首位列出（参数 STORE0）。
• 使用此方法配置的 Citrix Gateway 应用商店 URL 不支持使用 Citrix Gateway 的 PNA Services 站点。
• 指定 Citrix Gateway 应用商店 URL 时，不需要“Discovery”参数。

要配置多个应用商店，请执行以下操作：

CitrixWorkspaceApp.exe  STORE0= NetScaler Store;https://ag.mycompany.com#Storename;On;NetScaler Store
STORE1="StoreFront Store;https://testserver.net/Citrix/MyBackupStore/discovery;on; StoreFrontStore
<!--NeedCopy-->

注意：

• 请务必在应用商店 URL 中包括 discovery 以成功执行直通身份验证。
• Citrix Gateway 应用商店 URL 必须是已配置的应用商店 URL 列表中的第一个条目。

安装参数

启动 App Protection

• 命令：startAppProtection
• 说明：通过限制客户端受键盘记录和屏幕捕获恶意软件影响的能力，启动 App Protection 组件并提供增强的安全性。
• 示例： CitrixWorkspaceApp.exe startAppProtection

有关详细信息，请参阅 App Protection。

注意：

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

排除 Citrix Enterprise Browser 二进制文件

• 说明：排除 Citrix Enterprise Browser 二进制文件。
• 请运行以下命令以排除 Citrix Enterprise Browser：

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

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

• 全新安装
• 从不包含 Citrix Enterprise Browser 二进制文件的版本进行升级。

指定自定义安装目录

• 命令： 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 应用程序的任何特定组件时才使用 ADDLOCAL 键。默认情况下，如果未指定任何 ADDLOCAL 参数，则在安装 Citrix Workspace 应用程序时将安装支持的所有组件。

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

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

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

注意：

自版本 2212 起，默认安装 App Protection 功能。因此，AppProtection 不再是 ADDLOCAL 的有效选项。

限制：

使用 ADDLOCAL 参数安装 Citrix Workspace 应用程序时，连接中心可能无法响应设备和首选项窗口。仅当您不使用 DesktopViewer 参数安装 Citrix Workspace 应用程序时才会出现此问题。解决方法为，同时包括 DesktopViewer 参数。[HDX-67173]

安装 Citrix Casting

重要：

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

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

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

HDX 功能参数

设置双向内容重定向

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

下面是可能的值：

设置本地应用程序访问

• 命令：FORCE_LAA
• 说明：指示 Citrix Workspace 应用程序随客户端本地应用程序访问组件安装。请使用管理员权限安装 Workspace 应用程序，以便此组件能够运行。有关详细信息，请参阅“Citrix Virtual Apps and Desktops”文档中的本地应用程序访问。

下面是可能的值：

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

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

下面是可能的值：

显示文档或文件的图标

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

下面是可能的值：

首选项和用户界面参数

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

注意：

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

控制对自助服务的访问权限

• 命令：SELFSERVICEMODE
• 说明：控制对自助服务 Citrix Workspace 应用程序用户界面的访问。

下面是可能的值：

控制会话预启动

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

下面是可能的值：

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

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

下面是可能的值：

启用客户体验改善计划

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

下面是可能的值：

启用 AlwaysOn 跟踪

• 命令：EnableTracing
• 说明：控制 AlwaysOn 跟踪功能。

下面是可能的值：

指定用来识别用户设备的名称

• 命令：CLIENT_NAME
• 说明：指定服务器用来识别用户设备的名称。
• <ClientName> - 指定服务器上用来识别用户设备的名称。默认名称为 %COMPUTERNAME%。
• 示例：CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%。

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

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

下面是可能的值：

身份验证参数

包括单点登录

• 命令：/includeSSON
• 说明：要求您以管理员身份安装。指示 Citrix Workspace 应用程序随 Single Sign-On 组件安装。有关详细信息，请参阅域直通身份验证。
• 示例：CitrixWorkspaceApp.exe /includeSSON

注意：

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 and InstMsi.exe error messages（MsiExec.exe 和 InstMsi.exe 错误消息）。
• 有关系统相关的错误代码，请参阅 System error codes（系统错误代码）。

安装程序日志位置

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

注意：

自适用于 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) 管理模板配置。