安装和卸载

可以通过以下方式安装 Citrix Workspace 应用程序:

  • 下载页面下载 CitrixWorkspaceApp.exe 安装包,或者
  • 从贵公司的下载页面(如果可用)。

可以使用以下步骤安装该软件包:

  • 运行基于 Windows 的交互式安装向导。或
  • 使用命令行界面键入安装程序文件名、安装命令和安装属性。有关使用命令行界面安装 Citrix Workspace 应用程序的信息,请参阅使用命令行参数

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

用户和管理员都可以安装 Citrix Workspace 应用程序。仅当将直通身份验证Citrix Ready Workspace Hub 与适用于 Windows 的 Citrix Workspace 应用程序结合使用时才需要管理员权限。

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

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

注意:

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

使用基于 Windows 的安装程序

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

  • 安装介质
  • 网络共享
  • Windows 资源管理器
  • 命令行接口

默认情况下,安装程序日志位于 %temp%\CTXReceiverInstallLogs*.logs

  1. 启动 CitrixWorkspaceApp.exe 文件并单击启动
  2. 阅读并接受 EULA,然后继续安装。
  3. 在具有管理员权限的已加入域的计算机上进行安装时,会出现一个单点登对话框录。有关详细信息,请参阅域直通身份验证
  4. 按照基于 Windows 的安装程序完成安装。

安装完成后,Citrix Workspace 应用程序会请求您添加一个帐户。有关如何添加帐户的信息,请参阅添加帐户或切换服务器

使用命令行参数

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

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

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

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

CitrixWorkspaceApp.exe [commands] [properties]

命令行参数列表

参数大致分类如下:

常用参数

  • /?/help - 列出所有安装命令和属性。
  • /silent - 在安装过程中禁用安装对话框和提示。
  • /noreboot - 在安装过程中禁止显示重新启动提示。禁止显示重新启动提示时,处于暂停状态的 USB 设备无法识别。只有在重新启动设备后才会激活 USB 设备。
  • /includeSSON - 要求您以管理员身份安装。指示 Citrix Workspace 应用程序随 Single Sign-On 组件安装。有关详细信息,请参阅域直通身份验证
  • /rcu - /rcu 开关仅在从不受支持的软件版本升级时才有效。指示 Citrix Workspace 应用程序通过卸载现有版本完成安装或升级。/rcu 开关也会清除现有或较旧的设置。

    注意:

    /rcu 开关自版本 1909 起已弃用。有关详细信息,请参阅弃用

  • /forceinstall - 清理系统中安装的 Citrix Workspace 应用程序的任何现有配置或条目时,此开关非常有效。请在以下情况下使用此开关:

    • 从不受支持的 Citrix Workspace 应用程序版本进行升级。
    • 安装或升级不成功。

安装参数

/AutoUpdateCheck

指示 Citrix Workspace 应用程序在有可用更新时进行检测。

注意:

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

  • 自动(默认设置)- 系统将在有可用更新时向您发出通知。例如,CitrixWorkspaceApp.exe /AutoUpdateCheck=auto
  • 手动 - 系统在有可用更新时不向您发出通知。手动检查更新。例如,CitrixWorkspaceApp.exe /AutoUpdateCheck=manual
  • 已禁用 – 禁用自动更新。例如,CitrixWorkspaceApp.exe /AutoUpdateCheck=disabled

/AutoUpdateStream

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

  • LTSR - 仅自动更新到长期服务版本累积更新。例如,CitrixWorkspaceApp.exe /AutoUpdateStream=LTSR
  • 当前 - 自动更新到最新版本的 Citrix Workspace 应用程序。例如,CitrixWorkspaceApp.exe /AutoUpdateStream=Current

/DeferUpdateCount

指示更新可用时可以推迟通知的次数。有关详细信息,请参阅 Citrix Workspace 更新

  • -1(默认值)- 允许推迟任意次通知。例如,CitrixWorkspaceApp.exe /DeferUpdateCount=-1
  • 0 - 指示针对每个可用更新您将(仅)收到一条通知。不再提醒您有关此更新的信息。例如,CitrixWorkspaceApp.exe /DeferUpdateCount=0
  • 任何其他数字“n”- 允许推迟通知“n”次。以后提醒我选项显示“n”次。例如,CitrixWorkspaceApp.exe /DeferUpdateCount=<n>

/AURolloutPriority

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

  • 自动(默认值)- 您将在 Citrix 配置的交付周期内收到更新。例如,CitrixWorkspaceApp.exe /AURolloutPriority=Auto
  • 快 - 您将在交付周期开始时收到更新。例如,CitrixWorkspaceApp.exe /AURolloutPriority=Fast
  • 中 - 您将在交付期间中间时段收到更新。例如,CitrixWorkspaceApp.exe /AURolloutPriority=Medium
  • 慢 - 您将在交付周期结束时收到更新。例如,CitrixWorkspaceApp.exe /AURolloutPriority=Slow

/includeappprotection

通过限制客户端受键盘记录和屏幕捕获恶意软件影响的能力,提供增强的安全性。

  • CitrixWorkspaceApp.exe /includeappprotection

有关详细信息,请参阅 App Protection

/InstallEmbeddedBrowser

排除 Citrix Enterprise Browser 二进制文件。请运行 /InstallEmbeddedBrowser=N 开关以排除 Citrix Enterprise Browser 功能。

INSTALLDIR

指定 Citrix Workspace 应用程序安装的自定义安装目录。默认路径为 C:\Program Files\Citrix。例如,CitrixWorkspaceApp.exe INSTALLDIR=C:\Program Files\Citrix

ADDLOCAL

安装一个或多个指定的组件。例如,CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,AM,SSON,SELFSERVICE,DesktopViewer,WebHelper,WorkspaceHub,USB,AppProtection

注意:

默认情况下,ReceiverInsideICA_ClientAM 在安装 Citrix Workspace 应用程序时安装。

ADDLOCAL 将安装一个或多个指定的组件。

ReceiverInside、ICA_Client 和 AM 是必备项,在安装 Citrix Workspace 应用程序时默认安装。

  • ReceiverInside - 安装 Citrix Workspace 应用程序体验(必需)、系统托盘功能和自动更新。
  • ICA_Client - 安装 HDX 组件。
  • AM - 安装身份验证管理器组件。

还可以根据您的要求和环境安装以下模块:

  • SSON - 安装单点登录所需的组件。
  • SELFSERVICE - 安装自助服务插件。这允许您从 Citrix Workspace 应用程序窗口或命令行访问虚拟桌面和应用程序。如果未安装 SELFSERVICE,则可以通过 Web (Receiver for Web) 访问应用程序和桌面。
  • DesktopViewer - 安装 Desktop Viewer 以查看虚拟应用程序和桌面。
  • WebHelper:安装 WebHelper 组件。此组件用于从 StoreFront 中获取 ICA 文件并将其传递给 HDX Engine。它还会验证环境参数并将其与 StoreFront 共享。此组件在通过浏览器启动会话时使用。
  • WorkspaceHub:支持 Citrix Casting 的 Citrix Ready Workspace Hub。
  • USB – 安装 USB 支持功能。
  • AppProtection:安装 App Protection 组件。

HDX 功能参数

ALLOW_BIDIRCONTENTREDIRECTION

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

  • 0(默认值)- 指示双向内容重定向处于禁用状态。例如,CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=0
  • 1 - 指示双向内容重定向处于启用状态。例如,CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=1

FORCE_LAA

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

  • 0(默认值)- 指示未安装本地应用程序访问组件。例如,CitrixWorkspaceApp.exe FORCE_LAA =0
  • 1 - 指示安装客户端本地应用程序访问组件。例如,CitrixWorkspaceApp.exe FORCE_LAA =1

LEGACYFTAICONS

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

  • False(默认设置)- 显示与订购的应用程序具有文件类型关联的文档或文件的图标。设置为 false 时,操作系统将为没有为其指定特定图标的文档生成一个图标。操作系统生成的图标由较小版本的应用程序图标覆盖的通用图标组成。例如,CitrixWorkspaceApp.exe LEGACYFTAICONS=False
  • True - 不显示与订阅的应用程序具有文件类型关联的文档或文件的图标。例如,CitrixWorkspaceApp.exe LEGACYFTAICONS=True

ALLOW_CLIENTHOSTEDAPPSURL

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

  • 0(默认值)- 在用户设备上禁用 URL 重定向功能。例如,CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=0
  • 1- 在用户设备上启用 URL 重定向功能。例如,CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=1

首选项和用户界面参数

ALLOWADDSTORE

允许您根据指定的参数配置应用商店(HTTP 或 https)。

  • S(默认值)– 仅允许您添加或删除安全应用商店(使用 HTTPS 配置)。例如,CitrixWorkspaceApp.exe ALLOWADDSTORE=S
  • A – 允许您添加或删除安全应用商店 (HTTPS) 和非安全应用商店 (HTTP)。如果 Citrix Workspace 应用程序是按用户安装的,则不适用。例如,CitrixWorkspaceApp.exe ALLOWADDSTORE=A
  • N – 不允许用户添加或删除自己的应用商店。例如,CitrixWorkspaceApp.exe ALLOWADDSTORE=N

ALLOWSAVEPWD

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

  • S(默认值)– 仅允许保存安全应用商店的密码(已配置 HTTPS)。例如,CitrixWorkspaceApp.exe ALLOWSAVEPWD=S
  • N - 不允许保存密码。例如,CitrixWorkspaceApp.exe ALLOWSAVEPWD=N
  • A – 允许保存安全应用商店 (HTTPS) 和非安全应用商店 (HTTP) 的密码。例如,CitrixWorkspaceApp.exe ALLOWSAVEPWD=A

STARTMENUDIR

指定“开始”菜单中的快捷方式的目录。

  • <Directory Name> - 默认情况下,应用程序显示在开始 > 所有程序下。可以在 \Programs 文件夹中指定快捷方式的相对路径。例如,要将快捷方式放置在开始 > 所有程序 > Workspace 下,请指定 STARTMENUDIR=\Workspace

DESKTOPDIR

指定桌面快捷方式的目录。

注意:

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

  • <Directory Name> - 可以指定快捷方式的相对路径。例如,要将快捷方式放置在开始 > 所有程序 > Workspace 下,请指定 DESKTOPDIR=\Workspace

SELFSERVICEMODE

控制对自助服务 Citrix Workspace 应用程序用户界面的访问。

  • 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

  • True(默认设置)- 选择加入 Citrix 客户体验改善计划 (CEIP)。例如,CitrixWorkspaceApp.exe EnableCEIP=True
  • False - 选择退出 Citrix 客户体验改善计划 (CEIP)。例如,CitrixWorkspaceApp.exe EnableCEIP=False

EnableTracing

控制 AlwaysOn 跟踪功能。

  • True(默认设置)- 启用 AlwaysOn 跟踪功能。例如,CitrixWorkspaceApp.exe EnableTracing=true
  • False - 禁用 AlwaysOn 跟踪功能。例如,CitrixWorkspaceApp.exe EnableTracing=false

CLIENT_NAME

指定服务器用来识别用户设备的名称。

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

ENABLE_DYNAMIC_CLIENT_NAME

允许客户端名称与计算机名称相同。更改计算机名称时,客户端名称也会随之更改。

  • 是(默认设置)- 允许客户端名称与计算机名称相同。例如,CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=Yes
  • 否 - 不允许客户端名称与计算机名称相同。为 CLIENT_NAME 属性指定一个值。例如,CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No

身份验证参数

ENABLE_SSON

Citrix Workspace 应用程序通过 /includeSSON 命令安装时启用单点登录。有关详细信息,请参阅域直通身份验证

  • 是(默认设置)- 指示单点登录处于启用状态。例如,CitrixWorkspaceApp.exe ENABLE_SSON=Yes
  • 否 - 指示单点登录处于禁用状态。例如,CitrixWorkspaceApp.exe ENABLE_SSON=No

ENABLE_KERBEROS

指定 HDX 引擎是否必须使用 Kerberos 身份验证,并且仅在启用单点登录身份验证时才需要。有关详细信息,请参阅使用 Kerberos 的域直通身份验证

  • 是 - 指示 HDX 引擎必须使用 Kerberos 身份验证。例如,CitrixWorkspaceApp.exe ENABLE_KERBEROS=Yes
  • 否 - 指示 HDX 引擎不使用 Kerberos 身份验证。例如,CitrixWorkspaceApp.exe ENABLE_KERBEROS=No

除上述属性外,您还可以指定与 Citrix Workspace 应用程序结合使用的应用商店 URL。最多可以添加 10 个应用商店。请使用以下属性执行此操作:

STOREx=”storename;http[s]://servername.domain/IISLocation/discovery;[On, Off]; [storedescription]"

值:

  • x - 整数 0 到 9,用于标识应用商店。
  • storename - 应用商店的名称。此值必须与在 StoreFront 服务器上配置的名称一致。
  • servername.domain - 托管应用商店的服务器的完全限定域名。
  • IISLocation - IIS 内的应用商店路径。应用商店 URL 必须与 StoreFront 预配文件中的 URL 一致。应用商店 URL 的格式为 /Citrix/store/discovery。要获取 URL,请从 StoreFront 中导出一个预配文件,在记事本中将其打开,然后复制 Address 元素中的 URL。
  • [On, Off] - Off 选项允许您交付已禁用的应用商店,从而使用户能够选择是否访问这些应用商店。如果未指定应用商店状态,则默认设置为 On
  • storedescription - 应用商店的说明,例如 HR App Store

命令行安装示例

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

CitrixWorkspaceApp.exe STORE0= HRStore;https://ag.mycompany.com#Storename;On;Store

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

注意:

  • 使用此方法配置的 Citrix Gateway 应用商店 URL 不支持使用 Citrix Gateway 的 PNA Services 站点。
  • 在多应用商店设置中,Citrix Gateway 应用商店 URL 必须位于列表中的第一位。仅允许存在一个 Citrix Gateway 应用商店 URL 配置。

无提示安装所有组件并指定两个应用商店:

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

注意:

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

重置 Citrix Workspace 应用程序

重置 Citrix Workspace 应用程序将还原默认设置。

重置 Citrix Workspace 应用程序时,以下项目将重置:

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

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

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

要进行无提示重置,请使用以下命令:

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

注意:

请在参数中使用大写 U。

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

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

卸载

使用基于 Windows 的卸载程序:

您可以使用 Windows 的“程序和功能”实用程序(添加或删除程序)卸载 Citrix Workspace 应用程序。

注意:

在 Citrix Workspace 应用程序安装期间,您会收到一条卸载 Citrix HDX RTME 软件包的提示。单击确定继续卸载。

使用命令行接口:

可以从命令行键入以下命令卸载 Citrix Workspace 应用程序:

CitrixWorkspaceApp.exe /uninstall

对于无提示卸载 Citrix Workspace 应用程序,请运行以下开关:

CitrixWorkspaceApp.exe /silent /uninstall

注意:

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

安装和卸载