安装和卸载

管理员安装适用于 Windows 的 Citrix Workspace 应用程序 1912 LTSR 之前需要注意的事项

  • 适用于 Windows 的 Citrix Workspace 应用程序 1912 LTSR 需要 .NET Framework 4.6.2 或更高版本。Citrix Workspace 应用程序安装程序下载并安装 .NET Framework(如果您的系统中不存在)。但是,我们建议您在安装或更新 Citrix Workspace 应用程序之前手动安装所需的 .NET Framework。
  • 如果您尝试执行无人参与安装,请参阅知识中心文章 CTX257546
  • 要了解有关受支持和不受支持的密码套件的最新信息,请参阅知识中心文章 CTX250104

可以从下载页面或从贵公司的下载页面(如果可用)下载 CitrixWorkspaceApp.exe 安装包来安装 Citrix Workspace 应用程序。可以通过以下方式安装软件包:

  • 运行基于 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 每用户安装

注意:

如果系统中存在用户安装的适用于 Windows 的 Citrix Workspace 应用程序实例,并且管理员在同一系统中安装适用于 Windows 的 Citrix Workspace 应用程序,则将发生冲突。Citrix 建议您先卸载用户安装的所有适用于 Windows 的 Citrix Workspace 应用程序实例,然后再以管理员身份安装适用于 Windows 的 Citrix Workspace 应用程序。

使用基于 Windows 的安装程序

可以使用安装介质、网络共享、Windows 资源管理器或命令行通过手动运行 CitrixWorkspaceApp.exe 安装程序包安装适用于 Windows 的 Citrix Workspace 应用程序。

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

  1. 启动 CitrixWorkspaceApp.exe 文件并单击启动
  2. 阅读并接受“最终用户许可协议”,然后继续安装。
  3. 如果尝试在具有管理员权限的已加入域的计算机上进行安装,则会出现一个额外的对话框来启用或禁用单点登录。有关详细信息,请参阅域直通身份验证
  4. 按照基于 Windows 的安装程序完成安装。

使用命令行参数

可以通过在命令行界面中键入安装程序文件名、安装命令和安装属性来安装 Citrix Workspace 应用程序。可以通过指定命令行选项来自定义 Citrix Workspace 应用程序安装程序。安装程序包将在启动安装程序之前自解压到系统临时文件夹。空间要求包括程序文件、用户数据以及启动多个应用程序后使用的临时文件夹。

要使用 Windows 命令行安装 Citrix Workspace 应用程序,请启动命令提示符,然后在单行中键入安装程序文件名、安装命令和安装属性。下面列出了可用的安装命令和属性:

CitrixWorkspaceApp.exe [commands] [properties]

命令行参数列表

参数大致分类如下:

常用参数

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

    注意:

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

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

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

安装参数

/AutoUpdateCheck

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

  • 自动(默认设置)- 系统将在有可用更新时向您发出通知。例如,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

在使用 Citrix Virtual Apps and Desktops 和 Citrix DaaS(以前称为 Citrix Virtual Apps and Desktops 服务)时通过限制客户端受键盘记录和屏幕捕获恶意软件影响的能力,提高了安全性。

  • CitrixWorkspaceApp.exe /includeappprotection

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

INSTALLDIR

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

ADDLOCAL

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

HDX 功能参数

ALLOW_BIDIRCONTENTREDIRECTION

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

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

FORCE_LAA

指示 Citrix Workspace 应用程序随客户端本地应用程序访问组件安装。必须使用管理员权限安装 Citrix 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
  • ture - 指定不为与订购的应用程序具有文件类型关联的文档或文件显示应用程序图标。例如,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

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

  • 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)。有关详细信息,请参阅 CEIP

  • true(默认值)- 选择加入 CEIP。例如,CitrixWorkspaceApp.exe EnableCEIP=True
  • false - 选择退出 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 列表中的第一个条目。

卸载

使用基于 Windows 的卸载程序:

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

注意:

您会在继续安装适用于 Windows 的 Citrix Workspace 应用程序之前收到卸载 Citrix HDX RTME 软件包的提示。单击确定继续卸载。

使用命令行接口:

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

CitrixWorkspaceApp.exe /uninstall

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

CitrixWorkspaceApp.exe /silent /uninstall

注意:

  • 卸载后,receiver.adm/receiver.adml 或 receiver.admx 创建的注册表项将保留。
  • 如果您在卸载后在注册表编辑器中找到任何条目,请手动将其删除。
安装和卸载