安装和卸载

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

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

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

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

管理员执行的适用于 Windows 的 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 应用程序。

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

使用命令行参数

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

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

CitrixWorkspaceApp.exe [commands] [properties]

命令行参数列表

参数大致分类如下:

常用参数

  • /?/help - 列出所有安装命令和属性。
  • /silent - 在安装过程中禁用安装对话框和提示。
  • /noreboot - 在安装过程中禁止提示重新启动对话框。禁止显示重新启动提示时,处于暂停状态的 USB 设备在重新启动用户设备之后才能被 Workspace 应用程序识别。
  • /includeSSON - 要求您以管理员身份安装。指示 Citrix Workspace 应用程序随 Single Sign-On 组件安装。有关详细信息,请参阅域直通身份验证
  • /rcu - 此开关仅在从不受支持的软件版本升级时才有效。指示 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>.1

/AURolloutPriority

指示您可以暂缓推出更新的期限。

  • 自动(默认设置)- 在交付期间根据管理员的配置推出更新。例如,CitrixWorkspaceApp.exe /AURolloutPriority=Auto
  • 快 - 在交付期限的初期推出更新。例如,CitrixWorkspaceApp.exe /AURolloutPriority=Fast
  • 中 – 在交付期限的中期推出更新。例如,CitrixWorkspaceApp.exe /AURolloutPriority=Medium
  • 慢 - 在交付期限的末期推出更新。例如,CitrixWorkspaceApp.exe /AURolloutPriority=Slow

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

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 Virtual Apps and Desktops 文档中的本地应用程序访问部分。

  • 2-0(默认值)- 指示未安装本地应用程序访问组件。例如,CitrixWorkspaceApp.exe FORCE_LAA =2
  • 3-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。例如,CitrixWorkspaceApp.exe DESKTOPDIR=\Office

SELFSERVICEMODE

控制对自助服务 Workspace 应用程序用户界面的访问。请参阅“Fast Connect 3 凭据插入 API”文档中的会话管理

  • 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%

ENABLE_DYNAMIC_CLIENT_NAME

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

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

身份验证参数

ENABLE_SSON

Workspace 应用程序通过 /includeSSON 命令安装时启用 Single Sign-on。有关详细信息,请参阅域直通身份验证

  • 是(默认设置)- 指示 Single Sign-on 处于启用状态。例如,CitrixWorkspaceApp.exe /ENABLE_SSON=Yes
  • 否 - 指示 Single Sign-on 处于禁用状态。例如,CitrixWorkspaceApp.exe /ENABLE_SSON=No

ENABLE_KERBEROS

指定 HDX 引擎是否必须使用 Kerberos 身份验证。仅当启用了 Single Sign-on 身份验证时才适用。有关详细信息,请参阅通过 Kerberos 实现的域直通身份验证

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

除上述属性外,您还可以指定与 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 应位于列表中的第一位。

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

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 创建的注册表项仍保留在 HKEY_LOCAL_MACHINE 和 HKEY_LOCAL_USER 下的 Software\Policies\Citrix\ICA Client 目录中。
  • 如果您在卸载后在注册表编辑器中找到任何条目,请手动将其删除。

故障排除

如果安装出现问题,请在用户的 %TEMP%/CTXWorkspaceInstallLogs 目录中搜索带有前缀 CtxInstall- 或 TrolleyExpress- 的日志。例如,

CtxInstall-ICAWebWrapper-20141114-134516.log

TrolleyExpress-20090807-123456.log