安装和卸载

• 您可以采用以下任一方式安装 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 文件，然后单击开始。

• 1. 阅读并接受 EULA，然后继续安装。
• 1. 在具有管理员权限的已加入域的计算机上安装时，将显示单点登录对话框。有关详细信息，请参阅域直通身份验证。
• 1. 按照基于 Windows 的安装程序完成安装。

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

• 使用命令行参数

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

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

• 安装程序文件名、
• 安装命令和

• 安装属性

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

CitrixWorkspaceApp.exe [commands] [properties]

命令行参数列表

参数大致分类如下：

-  [常用参数](/zh-cn/citrix-workspace-app-for-windows/install.html#common-parameters)

• 安装参数
• HDX 功能参数
• 首选项和用户界面参数
• 身份验证参数

常用参数

• /? 或 /help - 列出所有安装命令和属性。
• /silent - 在安装过程中禁用安装对话框和提示。
• /noreboot - 抑制安装过程中的重启提示。当您抑制重启提示时，处于挂起状态的 USB 设备将无法识别。USB 设备仅在设备重启后才会激活。
• /includeSSON - 要求您以管理员身份安装。指示 Citrix Workspace 应用程序已安装单点登录组件。有关详细信息，请参阅域直通身份验证。
• /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® 会在特定的交付期内推出更新。通过此参数，您可以控制在交付期内的何时接收更新。

• Auto（自动，默认）- 您将在 Citrix 配置的交付期内接收更新。例如，CitrixWorkspaceApp.exe /AURolloutPriority=Auto。
• Fast（快速）- 您将在交付期开始时接收更新。例如，CitrixWorkspaceApp.exe /AURolloutPriority=Fast。
• Medium（中等）- 您将在交付期中期接收更新。例如，CitrixWorkspaceApp.exe /AURolloutPriority=Medium。
• Slow（慢速）- 您将在交付期结束时接收更新。例如，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。

注意：

• 默认情况下，在安装 Citrix Workspace 应用程序时会安装 ReceiverInside、ICA_Client 和 AM。

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

• ReceiverInside、ICA_Client 和 AM 是先决条件，默认情况下在安装 Citrix Workspace 应用程序时安装。

• ReceiverInside – 安装 Citrix Workspace 应用程序体验（必需）、系统托盘功能和自动更新。
• ICA_Client – 安装 HDX™ 组件。

• AM – 安装 Authentication Manager 组件。

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

• SSON – 安装单点登录所需的组件。
• SELFSERVICE – 安装自助服务插件。这允许您从 Citrix Workspace 应用程序窗口或命令行访问虚拟桌面和应用程序。如果未安装 SELFSERVICE，您可以通过 Web（适用于 Web 的 Receiver）访问应用程序和桌面。
• DesktopViewer – 安装用于查看虚拟应用程序和桌面的 Desktop Viewer。
• WebHelper：安装 WebHelper 组件。此组件从 StoreFront 检索 ICA 文件并将其传递给 HDX 引擎。它还会验证环境参数并与 StoreFront 共享。此组件在通过浏览器启动会话期间使用。
• WorkspaceHub：Citrix Ready workspace hub 组件，可启用 Citrix Casting。
• 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 app 是按用户安装的，则不适用。例如，CitrixWorkspaceApp.exe ALLOWADDSTORE=A。
• N – 绝不允许用户添加或删除自己的应用商店。例如，CitrixWorkspaceApp.exe ALLOWADDSTORE=N。

ALLOWSAVEPWD

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

• 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 app 用户界面的访问。

• 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

控制“始终启用跟踪”功能。

• True（默认）- 启用“始终启用跟踪”功能。例如，CitrixWorkspaceApp.exe EnableTracing=true。
• False - 禁用“始终启用跟踪”功能。例如，CitrixWorkspaceApp.exe EnableTracing=false。

CLIENT_NAME

指定用于向服务器标识用户设备的名称。

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

ENABLE_DYNAMIC_CLIENT_NAME

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

• Yes（默认）– 允许客户端名称与计算机名称相同。例如，CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=Yes。
• No - 不允许客户端名称与计算机名称相同。请为 CLIENT_NAME 属性指定一个值。例如，CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No。

身份验证参数

ENABLE_SSON

在使用 /includeSSON 命令安装 Citrix Workspace app 时启用单点登录。有关详细信息，请参阅域直通身份验证。

• Yes（默认）- 表示单点登录已启用。例如，CitrixWorkspaceApp.exe ENABLE_SSON=Yes。
• No - 表示单点登录已禁用。例如，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
<!--NeedCopy-->

其中，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 更新它们或手动删除它们。