安装和卸载

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

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

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

    或者

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

注意:

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

  • 升级到更高版本的 Citrix Workspace 应用程序时,请使用 CitrixWorkspaceApp.exe /CleanInstall 命令。

  • 对于降级,Citrix 建议您卸载现有版本,然后安装所需版本。

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

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

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

  安装文件夹 安装类型
管理员 对于 64 位:C:\Program Files\Citrix\ICA Client;对于 32 位:C:\Program Files (x86)\Citrix\ICA Client 每系统安装
用户 %USERPROFILE%\AppData\Local\Citrix\ICA Client 每用户安装

注意:

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

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

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

例如:

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

注意:

forceinstallcleaninstall 命令之间的区别在于,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 安装程序屏幕。

     -  1.  单击**继续**。将显示**Citrix 许可协议**页面。   -  1.  阅读并接受 Citrix 许可协议,然后继续安装。Citrix Workspace 应用程序安装将继续并成功完成。
    
  2. 使用管理员权限安装时,您可以从附加组件页面中选择以下选项:

     -  安装后启动应用程序保护   -  启用单点登录   -  安装 Microsoft Teams VDI 插件
     -  从适用于 Windows 的 Citrix Workspace 应用程序版本 2508 开始,此选项默认处于选中状态。用户可以清除此选项以防止安装 Microsoft Teams VDI 插件。   -  安装 Zoom VDI 插件
     -  从适用于 Windows 的 Citrix Workspace 应用程序版本 2511 开始,此选项默认处于选中状态。用户可以清除此选项以防止安装 Zoom VDI 插件。   -  安装 Cisco WebEx VDI 插件
    

安装程序

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

SSON

重要提示:

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

使用 Windows 应用商店

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

    Citrix Workspace 应用程序应用商店安装

  1. 单击“获取”。Citrix Workspace 应用程序随即安装。

注意:

在通过 Windows 应用商店安装 Citrix Workspace 应用程序时,不支持第三方插件和插件管理组件,例如 Microsoft Teams VDI 插件或 Zoom 插件管理。

基于命令行的安装

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

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

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

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

CitrixWorkspaceApp.exe [commands] [properties]

命令行参数列表

参数大致分类如下:

常用参数

命令 说明
?help 列出所有安装命令和属性。
/silent 在安装过程中禁用安装对话框和提示。
/forceinstall 此开关在清理系统中 Citrix Workspace 应用程序的任何现有配置或条目时有效。当从不受支持的 Citrix Workspace 应用程序版本升级以及安装或升级不成功时,请使用此开关。
  • 注意:

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

    forceinstallcleaninstall 命令之间的区别在于,当发生不受支持的版本升级或任何故障时,forceinstall 会运行,而 cleaninstall 始终在执行所需操作(无论是安装还是升级)之前进行清理。

自动更新参数

检测可用更新

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

可能的值如下:

AutoUpdateCheck 命令值 说明 示例
自动(默认) 当有可用更新时,您会收到通知。 CitrixWorkspaceApp.exe AutoUpdateCheck=auto
手动 当有可用更新时,您不会收到通知。请手动检查更新。 CitrixWorkspaceApp.exe AutoUpdateCheck=manual
已禁用 禁用自动更新。 CitrixWorkspaceApp.exe AutoUpdateCheck=disabled

注意:

AutoUpdateCheck 是一个强制参数,您必须设置此参数才能配置其他参数,例如 AutoUpdateStreamDeferUpdateCountAURolloutPriority

选择要更新的版本

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

可能的值如下:

AutoUpdateStream 命令值 说明 示例
LTSR 仅自动更新到长期服务版本 (Long Term Service Release) 累积更新。 CitrixWorkspaceApp.exe AutoUpdateStream=LTSR
当前 自动更新到最新版本的 Citrix Workspace 应用程序。 CitrixWorkspaceApp.exe AutoUpdateStream=Current

推迟更新通知

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

可能的值如下:

DeferUpdateCount 命令值 说明 示例
-1(默认) 允许无限次推迟通知 CitrixWorkspaceApp.exe DeferUpdateCount=-1
0 表示您针对每个可用更新仅接收一次通知。不会再次提醒您有关该更新的信息。 CitrixWorkspaceApp.exe DeferUpdateCount=0
任何其他数字“n”
  • 允许推迟通知“n”次。稍后提醒我选项在“n”计数中显示。
CitrixWorkspaceApp.exe DeferUpdateCount=<n>

注意:

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

设置推出优先级

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

  • 可能的值如下:

|AURolloutPriority 命令值|说明|示例| |————————————————–|—|—|

  • Auto(默认) 您将在 Citrix 配置的交付期内收到更新。 CitrixWorkspaceApp.exe AURolloutPriority=Auto
    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 应用程序协议的应用商店。

  • 可能的值如下:
ALLOWSAVEPWD 命令值 说明 示例
S(默认) 仅允许保存安全应用商店(使用 HTTPS 配置)的密码。 CitrixWorkspaceApp.exe ALLOWSAVEPWD=S
N 不允许保存密码。 CitrixWorkspaceApp.exe ALLOWSAVEPWD=N
A 允许保存安全应用商店 (HTTPS) 和非安全应用商店 (HTTP) 的密码。 CitrixWorkspaceApp.exe ALLOWSAVEPWD=A

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

指定 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 二进制文件的版本进行升级。

注意:

  • 从版本 2511 开始,Citrix Enterprise Browser 不再受 Citrix Workspace 应用程序 for Windows 支持。如有需要,用户和管理员可以从 Citrix 下载页面的 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 键支持的组件:
ADDLOCAL 键 组件名称 说明
ReceiverInside Receiver 为自助服务插件提供 Workspace SDK 服务。
ICA_Client HDX™ 引擎 此组件处理 ICA 文件或会话启动过程。
BCR_Client BCR 客户端 用于处理浏览器内容重定向的插件。
  • USB USB 客户端 用于处理 USB 重定向的插件。
  • DesktopViewer Desktop Viewer 客户端 虚拟桌面的 UI 框架。
    AM AuthManager 身份验证管理器 - 授权用户访问 Citrix Workspace 应用程序。
    SSON SSON 单点登录组件 – 支持单点登录。
    SELFSERVICE 自助服务 用于 Citrix Workspace 本机启动的插件。
    WebHelper Web 助手 用于将浏览器与本机 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]

安装第三方插件

Citrix Workspace 应用程序支持以下第三方插件和插件管理组件:

  • Microsoft Teams VDI 插件

从 Citrix Workspace 应用程序 for Windows 版本 2508 开始,此组件默认安装。

全新安装和手动更新
  • 默认情况下,此安装选项处于选中状态。
  • 用户可以根据自己的偏好清除此选项。
自动更新
  • 如果组件尚不存在,则默认安装。
  • 当有新版本可用时,现有安装将升级。

为防止安装 Microsoft Teams VDI 插件,管理员可以使用以下命令行:

CitrixWorkspaceapp.exe /InstallMSTeamsPlugin=N

  • 从适用于 Windows 的 Citrix Workspace 应用程序版本 2508 开始,在升级期间,应用程序会记住之前的选择。要在升级期间安装 Microsoft Teams VDI 插件(如果之前未选择),管理员可以使用以下命令行:

CitrixWorkspaceapp.exe /InstallMSTeamsPlugin=Y

Zoom VDI 插件管理

从适用于 Windows 的 Citrix Workspace 应用程序版本 2511 开始,此组件默认安装。

  • 全新安装和手动更新
  • 默认情况下,此安装选项处于选中状态。
  • 用户可以根据自己的偏好清除此选项。
自动更新
  • 如果组件尚不存在,则默认安装。
  • 当有新版本可用时,现有安装将升级。

  • 为防止安装 Zoom VDI 插件,管理员可以使用以下命令行:

  • CitrixWorkspaceapp.exe Installzoomplugin=N
WebEx VDI 插件安装程序引擎

要安装 WebEx VDI 插件安装程序引擎:

全新安装和手动更新
  • 默认情况下,此安装选项处于未选中状态。
  • 用户可以根据自己的偏好选择此选项。

  • 自动更新
  • 默认情况下不安装此组件。
  • 当使用早期版本的 Citrix Workspace 应用程序安装了现有组件且有更新的组件版本可用时,现有安装将升级。

要安装 WebEx VDI 插件安装程序引擎,管理员可以使用以下命令行:

CitrixWorkspaceapp.exe ADDONS=WebexVDIPlugin

  • 注意:

    • 第三方组件是从各自的第三方 CDN 获取的,而不是与 Citrix Workspace 应用程序打包在一起。客户必须确保端点具有必要的网络访问权限,才能在联机和脱机 Citrix Workspace 应用程序软件包上成功安装组件。

    • 第三方组件安装失败不会影响 Citrix Workspace 应用程序的安装。

    • 可以通过重新运行安装程序或在升级期间重新安装失败的组件。

    • Citrix Workspace 应用程序在卸载时不会管理第三方插件的卸载。

    • Citrix Workspace 应用程序会在更新时保留组件选择。例如,如果在安装过程中取消选择 Microsoft Teams 插件,则在后续版本中不会自动安装该插件。

    • Citrix 建议启用 Citrix Workspace 应用程序自动更新,以便在第三方组件可用时接收其最新版本。

    • 这些插件是第三方软件,并非由 Cloud Software Group 创建、开发或管理。Cloud Software Group 对任何第三方服务或软件不承担任何义务或责任通过下载和/或使用此类软件您在此确认并同意 Cloud Software Group 按“原样”提供此类软件,不提供任何形式的担保,并且您访问和/或使用该软件或任何相关资产的风险由您自行承担您承认您受此类软件各自的第三方许可协议的约束

安装 Citrix Casting™

重要提示:

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

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

  • 有关 Citrix Casting 的详细信息,请参阅 Citrix Casting

UberAgent 参数

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

使用以下命令行安装:

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

注意:

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

  • Session Recording 代理参数

  • 命令: InstallSRAgent
  • 说明: Session Recording 附加组件将会话监视功能直接扩展到端点设备,从而全面监督各种应用程序和端点环境中的用户活动。此集成可简化部署并有助于减少管理开销。

使用以下命令行安装:

使用命令 /InstallSRAgent 安装或升级用于端点设备的 Session Recording 代理。 如果 Session Recording 代理已存在,请使用命令 /InstallSRAgent /SkipSRAgentUpgrade 安装插件而不升级。此选项非常适合 Session Recording 代理部署与 Citrix Workspace 应用程序分开管理的设备。

注意:

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

如果您使用的是 Citrix Workspace 应用程序 x86 安装程序,则此计算机上需要 .NET Desktop Runtime 8.0.15 或更高版本(最高 8.x)的 x64 版本才能完成安装。

HDX 功能参数

  • 设置双向内容重定向

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

可能的值如下:

ALLOW_BIDIRCONTENTREDIRECTION 命令值 说明 示例
0(默认值) 指示双向内容重定向已禁用。 CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=0
1 指示双向内容重定向已启用。 CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=1

设置本地应用程序访问

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

可能的值如下:

FORCE_LAA 命令值 说明 示例
0(默认值) 指示未安装本地应用程序访问组件。 CitrixWorkspaceApp.exe FORCE_LAA =0
1 指示已安装客户端本地应用程序访问组件。 CitrixWorkspaceApp.exe FORCE_LAA =1

在用户设备上设置 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
  • 说明: 指定是否要显示与订阅应用程序具有文件类型关联的文档或文件的图标。

可能的值如下:

LEGACYFTAICONS 命令值 说明 示例
False(默认值) 显示与订阅应用程序具有文件类型关联的文档或文件的图标。当设置为 False 时,操作系统会为未分配特定图标的文档生成一个图标。操作系统生成的图标是通用图标,上面叠加了应用程序图标的较小版本。 CitrixWorkspaceApp.exe LEGACYFTAICONS=False
True 不显示与订阅应用程序具有文件类型关联的文档或文件的图标。 CitrixWorkspaceApp.exe LEGACYFTAICONS=True

首选项和用户界面参数

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

命令值 说明 目录名称 示例
CitrixWorkspaceApp.exe STARTMENUDIR 指定“开始”菜单中快捷方式的目录。 默认情况下,应用程序显示在 “开始” > “所有程序” 下。您可以在 Programs 文件夹中指定快捷方式的相对路径。 要将快捷方式放置在 “开始” > “所有程序” > Workspace 下,请指定 STARTMENUDIR=Workspace
CitrixWorkspaceApp.exe DESKTOPDIR 指定桌面上的快捷方式目录。 您可以指定快捷方式的相对路径。 要将快捷方式放置在 “开始” > “所有程序” > Workspace 下,请指定 DESKTOPDIR=Workspace

注意:

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

控制对自助服务的访问

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

可能的值如下:

SELFSERVICEMODE 命令值 说明 示例
True 指示用户可以访问自助式用户界面。 CitrixWorkspaceApp.exe SELFSERVICEMODE=True
False 指示用户无法访问自助式用户界面。 CitrixWorkspaceApp.exe SELFSERVICEMODE=False

控制会话预启动

可能的值如下:

ENABLEPRELAUNCH 命令值 描述 示例
True 表示会话预启动已启用。 CitrixWorkspaceApp.exe ENABLEPRELAUNCH=True
False 表示会话预启动已禁用。 CitrixWorkspaceApp.exe ENABLEPRELAUNCH=False

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

可能的值如下:

DisableSetting 命令值 描述 示例
0(默认) 在“高级首选项”工作表中显示“快捷方式”和“重新连接”选项。 CitrixWorkspaceApp.exe DisableSetting=0
1 仅在“高级首选项”工作表中显示“重新连接”选项。 CitrixWorkspaceApp.exe DisableSetting=1
2 仅在“高级首选项”工作表中显示“快捷方式”选项。 CitrixWorkspaceApp.exe DisableSetting=2
3 快捷方式”和“重新连接”选项均从“高级首选项”工作表中隐藏。 CitrixWorkspaceApp.exe DisableSetting=3

启用客户体验改善计划

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

可能的值如下:

EnableCEIP 命令值 描述 示例
True(默认) 选择加入 Citrix 客户改善计划 (CEIP) CitrixWorkspaceApp.exe EnableCEIP=True
False 选择退出 Citrix 客户改善计划 CitrixWorkspaceApp.exe EnableCEIP=False

启用始终开启的跟踪

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

可能的值如下:

EnableTracing 命令值 描述 示例
True(默认) 启用“始终开启的跟踪”功能。 CitrixWorkspaceApp.exe EnableTracing=true
False 禁用“始终开启的跟踪”功能。 CitrixWorkspaceApp.exe EnableTracing=false

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

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

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

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

可能的值如下:

ENABLE_DYNAMIC_CLIENT_NAME 命令值 描述 示例
Yes(默认) 允许客户端名称与计算机名称相同。 CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=Yes
No 不允许客户端名称与计算机名称相同。为 CLIENT_NAME 属性指定一个值。 CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No

身份验证参数

包括单点登录

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

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

注意:

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

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

启用单点登录

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

可能的值如下:

ENABLE_SSON 命令值 描述 示例
Yes(默认) 表示单点登录已启用。 CitrixWorkspaceApp.exe ENABLE_SSON=Yes
No 表示单点登录已禁用。 CitrixWorkspaceApp.exe ENABLE_SSON=No

卸载 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 更新或手动删除它们。

故障排除

错误代码

安装程序日志位置

默认情况下,安装程序日志位于以下位置:

  安装日志文件夹 安装类型
管理员 对于 64 位:C:\Program Files (x86)\Citrix\Logs;对于 32 位:C:\Program Files\Citrix\ICA Client 每系统安装
用户 %USERPROFILE%\AppData\Local\Citrix\Logs 每用户安装

注意:

从适用于 Windows 的 Citrix Workspace 应用程序 2311.1 版本开始,TrolleyExpress 已替换为 CWAInstaller-<日期和时间戳>。例如,日志记录在 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) 管理模板配置。
安装和卸载