安装和卸载
-
管理员在安装适用于 Windows 的 Citrix Workspace 应用程序 1912 LTSR 之前的注意事项
- 适用于 Windows 的 Citrix Workspace 应用程序 1912 LTSR 需要 .NET Framework 4.6.2 或更高版本。如果您的系统上未安装 .NET Framework，Citrix Workspace 应用程序安装程序将下载并安装它。但是，我们建议您在安装或更新 Citrix Workspace 应用程序之前手动安装所需的 .NET Framework。
- 如果您尝试执行无人参与安装，请参阅知识中心文章 CTX257546。
您可以通过从 下载页面 或您公司的下载页面（如果可用）下载 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。 -
- 启动
CitrixWorkspaceApp.exe文件，然后单击开始。
- 启动
-
- 阅读并接受最终用户许可协议，然后继续安装。
- 如果您尝试在具有管理员权限的已加入域的计算机上进行安装，则会出现一个附加对话框，用于启用或禁用单点登录。有关详细信息，请参阅 域直通身份验证。
-
- 按照基于 Windows 的安装程序完成安装。
-
使用命令行参数
- 您可以通过从命令行界面键入安装程序文件名、安装命令和安装属性来安装 Citrix Workspace 应用程序。您可以通过指定命令行选项来自定义 Citrix Workspace 应用程序安装程序。安装程序包在启动 Setup 之前会自解压到系统临时文件夹。空间要求包括程序文件、用户数据以及启动多个应用程序后的临时文件夹。
要使用 Windows 命令行安装 Citrix Workspace 应用程序，请启动命令提示符，然后在一行中键入安装程序文件名、安装命令和安装属性。可用的安装命令和属性如下所示：
CitrixWorkspaceApp.exe [commands] [properties]
命令行参数列表
参数大致分类如下：
- 常用参数
- 安装参数
-
常用参数
-
/?或/help- 列出所有安装命令和属性。 -
/silent- 在安装过程中禁用安装对话框和提示。 -
/noreboot- 在安装过程中禁止重新启动对话框提示。当您禁止重新启动提示时，处于挂起状态的 USB 设备在用户设备重新启动之前不会被 Citrix Workspace 应用程序识别。 -
/includeSSON- 要求您以管理员身份安装。指示 Citrix Workspace 应用程序已安装单点登录组件。有关详细信息，请参阅 域直通身份验证。 -
/rcu- 此开关仅在从不受支持的软件版本升级时有效。指示 Citrix Workspace 应用程序将通过卸载现有版本进行安装或升级。这还会清除现有设置。注意：
-
-
从 1909 版本开始，
/rcu开关已弃用。有关详细信息，请参阅 弃用。 -
/forceinstall- 在以下情况下，此开关在清除系统上 Citrix Workspace 应用程序的任何现有配置或条目时有效：- 您正在从不受支持的 Citrix Workspace 应用程序版本升级。
- 安装或升级不成功。
安装参数
/AutoUpdateCheck
指示 Citrix Workspace 应用程序检测何时有可用更新。
- Auto（默认）- 当有可用更新时，您会收到通知。例如，
CitrixWorkspaceApp.exe /AutoUpdateCheck=auto。 - Manual - 当有可用更新时，您不会收到通知。手动检查更新。例如，
CitrixWorkspaceApp.exe /AutoUpdateCheck=manual。 - Disabled - 禁用自动更新。例如，
CitrixWorkspaceApp.exe /AutoUpdateCheck=disabled。
/AutoUpdateStream
-
如果您已启用自动更新，则可以选择要更新到的发布轨道。有关详细信息，请参阅 生命周期里程碑。
- LTSR - 仅自动更新到长期服务版本累积更新。示例：
CitrixWorkspaceApp.exe /AutoUpdateStream=LTSR。 - Current - 自动更新到 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 -
有关详细信息，请参阅 应用程序保护。
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。 -
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
允许您在本地保存应用商店凭据。此参数仅适用于使用 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
控制“始终启用跟踪”功能。
- True（默认）- 启用“始终启用跟踪”功能。例如，
CitrixWorkspaceApp.exe EnableTracing=true。 - False - 禁用“始终启用跟踪”功能。例如，
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 Gateway 应用商店 URL：
CitrixWorkspaceApp.exe STORE0=HRStore;https://ag.mycompany.com#Storename;On;Store
其中 Storename 指示需要配置的应用商店的名称。
注意：
- 使用此方法配置的 Citrix Gateway 应用商店 URL 不支持使用 Citrix Gateway 的 PNA Services Sites。
- 如果配置了多个应用商店，请将 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 创建的注册表项在卸载后仍会保留。
- 如果在卸载后在注册表编辑器中找到任何条目，请手动将其删除。