Product Documentation

使用命令行参数配置和安装 Citrix Receiver for Windows

Jan 20, 2017

可以通过指定命令行选项自定义 Citrix Receiver for Windows 安装程序。 安装程序包将在启动安装程序前自解压到用户的临时目录中,并且要求 %temp% 目录中大约具有 57.8 MB 的可用空间。 空间要求包括程序文件、用户数据以及启动多个应用程序后使用的临时目录。 

要从命令提示窗口中安装 Citrix Receiver for Windows,请使用以下语法:

CitrixReceiver.exe [Options]

Enable Local App Access

Option FORCE_LAA=1
Description By default, Citrix Receiver for Windows does not install the client side Local App Access components if the components are already installed on the server. To force the client side Local App Access components on the Citrix Receiver, use FORCE_LAA command line switch. Requires administrator rights.
For more information on Local App Access, see Local App Access in XenApp and XenDesktop documentation.
Sample usage CitrixReceiver.exe FORCE_LAA =1

显示使用信息

选项/? 或 -help
说明 此开关显示用法信息
示例用法

CitrixReceiver.exe /?

CitrixReceiver.exe /help

禁止在 UI 安装期间重新启动

选项/noreboot
说明
禁止在 UI 安装期间重新启动。 无提示安装不需要此选项。 如果您禁止显示重新启动提示,Citrix Receiver for Windows 安装时处于暂停状态的任何 USB 设备在重新启动用户设备后才能被 Citrix Receiver for Windows 识别。
示例用法CitrixReceiver.exe /noreboot

无提示安装

选项/silent
说明
禁用错误和进度对话框以执行完全无提示安装。
示例用法CitrixReceiver.exe /silent

启用单点登录身份验证

选项/includeSSON
说明

安装单点登录(直通)身份验证。 智能卡单点登录需要此选项。

命令行中包含 /includeSSON 时,启用相关选项 ENABLE_SSON。 如果要使用 ADDLOCAL= 指定各项功能,并希望安装 Single Sign-On,则还必须指定值 SSON。

要为用户设备启用直通身份验证,必须从包含选项 /includeSSON 的命令行通过本地管理员权限安装 Citrix Receiver for Windows。 在用户设备上,还必须启用“管理模板”>“经典管理模板(ADM)”>“Citrix 组件”>“Citrix Receiver”>“用户身份验证”中的以下策略:

  • 本地用户名和密码
  • 启用直通身份验证
  • 允许对所有 ICA 执行直通身份验证(可能需要,具体取决于 Web Interface 配置和安全设置)

在完成更改后,重新启动用户设备。 有关详细信息,请参阅 How to Manually Install and Configure Citrix Receiver for Pass-Through Authentication(如何手动安装和配置 Citrix Receiver 以实现直通身份验证)一文。

注意:智能卡、Kerberos 以及本地用户名和密码策略相互依赖。 配置顺序非常重要。 建议首先禁用不需要的策略,然后启用所需的策略。 请仔细验证结果。

示例用法CitrixReceiver.exe /includeSSON

在指定了 /includeSSON 时启用 Single Sign-On

Option ENABLE_SSON={Yes | No}
Description

Enable Single Sign-on when /includeSSON is specified. The default value is Yes. Enables Single Sign-on when /includeSSON is also specified. This property is required for smart card Single Sign-on.
Note that users must log off and log back on to their devices after an installation with Single Sign-on authentication enabled. Requires administrator rights.

Sample usage CitrixReceiver.exe /ENABLE_SSON=Yes

AlwaysOn 跟踪

选项/EnableTracing={true | false}
说明
默认情况下启用此功能。 使用此属性可明确启用或禁用 AlwaysOn 跟踪功能。 AlwaysOn 跟踪功能可帮助收集与连接时间有关的关键日志。 解决间歇性出现的连接问题时,这些日志证明非常有用。 AlwaysOn 跟踪策略将覆盖此设置。
示例用法CitrixReceiver.exe /EnableTracing=true

使用 Citrix 客户体验改善计划 (CEIP)

选项/EnableCEIP={true | false}
说明
如果允许参与 Citrix 客户体验改善计划 (CEIP),匿名统计数据和使用信息将发送给 Citrix 以帮助 Citrix 改进其产品质量和性能。 
示例用法CitrixReceiver.exe /EnableCEIP=true

指定安装目录

选项INSTALLDIR=<安装目录>
说明

指定安装路径,其中安装目录为大多数 Citrix Receiver 软件的安装位置。 默认值为 C:\Program Files\Citrix\Receiver。 以下 Receiver 组件将安装在路径 C:\Program Files\Citrix 中:身份验证管理器、Citrix Receiver 和自助服务插件。

如果您使用此选项并指定了一个安装目录,则必须在安装目录 \Receiver 目录中安装 RIInstaller.msi,并在安装目录中安装其他 .msi 文件。

示例用法CitrixReceiver.exe INSTALLDIR=c:\Citrix\Test

识别连接到服务器场的用户设备

选项CLIENT_NAME=<ClientName>
说明
指定客户端名称,其中 ClientName 用来识别连接到服务器场的用户设备的名称。 默认值为 %COMPUTERNAME%
示例用法CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%.

动态客户端名称

选项ENABLE_CLIENT_NAME=Yes | No
说明
动态客户端名称功能可以使客户端名称始终与计算机名称相同。 当用户更改其计算机名称时,客户端名称会随之相应更改。 默认值为 Yes。 要禁用动态客户端名称支持,请将此属性设置为 No,并为 CLIENT_NAME 属性指定一个值。
示例用法CitrixReceiver.exe DYNAMIC_NAME=Yes

安装指定的组件

选项ADDLOCAL=<feature... ,>
说明

安装一个或多个指定的组件。 指定多个参数时,请用逗号分隔每个参数,并且参数之间不能有空格。 名称区分大小写。 如果未指定此参数,则默认安装所有组件。

Citrix 建议您使用下面提供的 ADDLOCAL 示例用法。 如果未按所述内容使用示例用法,则可能会导致出现意外行为。

这些组件包括:

  • ReceiverInside – 安装 Citrix Receiver 体验(Receiver 操作的必需组件)。
  • ICA_Client – 安装标准 Citrix Receiver(Receiver 操作的必需组件)。
  • WebHelper – 安装 WebHelper 组件。 此组件用于从 StoreFront 中获取 ICA 文件并将其传递给 HDX Engine。 此外,还用于验证环境参数并将其与 StoreFront 共享(与 ICO 客户端检测类似)。
  • [可选] SSON – 安装 Single Sign-On。 需要具有管理员权限。
  • AM – 安装身份验证管理器。
  • SELFSERVICE – 安装自助服务插件。 必须在命令行中指定 AM 值,且必须在用户设备上安装 .NET 3.5 Service Pack 1。 自助服务插件对 Windows Thin PC 设备不可用,该设备不支持 .NET 3.5。
  • 有关为自助服务插件 (SSP) 编写脚本和 Receiver for Windows 4.2 及更高版本中可用参数列表的信息,请参阅知识中心文章 CTX200337
  • 自助服务插件允许用户从 Receiver 窗口或命令行访问虚拟桌面和应用程序,如本部分后面的“从命令行启动虚拟桌面或应用程序”中所述。
  • USB – 安装 USB 支持功能。 需要具有管理员权限。
  • DesktopViewer – 安装 Desktop Viewer。
  • Flash – 安装 HDX Media Stream for Flash。
  • Vd3d – 启用 Windows Aero 体验(面向支持此功能的操作系统)。
示例用法CitrixReceiver.exe ADDLOCAL=ReceiverInside,ICA_Client,AM,SELFSERVICE,DesktopViewer,Flash,Vd3d,usb,WebHelper

配置 Citrix Receiver for Windows 以手动添加应用商店

选项ALLOWADDSTORE={N | S | A}
说明

指定用户是否能够添加和删除未通过 Merchandising Server 交付对象配置的应用商店;用户可以启用或禁用通过 Merchandising Server 交付对象配置的应用商店,但不能删除这些应用商店或者更改名称或 URL。默认值为 S。 选项包括:

  • N – 不允许用户添加或删除自己的应用商店。
  • S – 仅允许用户添加或删除安全应用商店(已配置 HTTPS)。
  • A – 允许用户添加或删除安全应用商店 (HTTPS) 和非安全应用商店 (HTTP)。 如果 Citrix Receiver 是按每用户方式安装的,则不适用。

也可以通过更新注册表项 HKLM\Software\[Wow6432Node\]Citrix\Dazzle\AllowAddStore 控制此功能。

注意:默认情况下仅允许安全 (HTTPS) 应用商店并建议将其用于生产环境。 在测试环境中,您可以通过以下配置使用 HTTP 应用商店连接:

  1. 将 HKLM\Software\[Wow6432Node\]Citrix\Dazzle\AllowAddStore 设置为 A 以允许用户添加非安全应用商店。
  2. 将 HKLM\Software\[Wow6432Node\]Citrix\Dazzle\AllowSavePwd 设置为 A 以允许用户保存非安全应用商店的密码。
  3. 要添加在 StoreFront 中配置的 TransportType 为 HTTP 的应用商店,请将值 ConnectionSecurityMode(REG_SZ 类型)添加到 HKLM\Software\[Wow6432Node\]Citrix\AuthManager 并将其设置为 Any。
  4. 退出并重新启动 Citrix Receiver。
示例用法CitrixReceiver.exe ALLOWADDSTORE=N

使用 PNAgent 协议在本地保存应用商店的凭据

选项ALLOWSAVEPWD={N | S | A}
说明

指定用户是否能够添加和删除未通过 Merchandising Server 交付对象配置的应用商店;用户可以启用或禁用通过 Merchandising Server 交付对象配置的应用商店,但不能删除这些应用商店或者更改名称或 URL。默认值为 S。 选项包括:

  • N – 不允许用户保存密码。
  • S – 仅允许用户保存安全应用商店的密码(已配置 HTTPS)。
  • A – 允许用户保存安全应用商店 (HTTPS) 和非安全应用商店 (HTTP) 的密码。

也可以通过更新注册表项 HKLM\Software\[Wow6432Node]\Citrix\Dazzle\AllowSavePwd 控制此功能。

注意:如果 AllowSavePwd 不起作用,则必须手动添加以下注册表项。

  • 32 位操作系统客户端的注册表项:HKLM\Software\Citrix\AuthManager
  • 64 位操作系统客户端的注册表项:HKLM\Software\wow6432node\Citrix\AuthManager
  • 类型:REG_SZ
  • 值:never – 绝不允许用户保存密码。 secureonly – 仅允许用户保存安全应用商店的密码(通过 HTTPS 配置)。 always – 允许用户保存安全应用商店 (HTTPS) 和不安全应用商店 (HTTP) 的密码。
示例用法CitrixReceiver.exe ALLOWSAVEPWD=N

选择证书

选项AM_CERTIFICATESELECTIONMODE={Prompt | SmartCardDefault | LatestExpiry}
说明

使用此选项选择证书。默认值为 Prompt,该值将提示用户从列表中选择证书。 更改此属性可选择默认证书(根据智能卡提供商)或近期即将过期的证书。 如果没有有效的登录证书,则会向用户发出通知,并提供使用其他可用登录方法的选项。

还可以通过更新注册表项 HKCU 或 HKLM\Software\[Wow6432Node\]Citrix\AuthManager: CertificateSelectionMode={ Prompt | SmartCardDefault | LatestExpiry } 控制此功能。 在 HKCU 中定义的值优先级高于 HKLM 中的值,可更好地帮助用户选择证书。

示例用法CitrixReceiver.exe AM_CERTIFICATESELECTIONMODE=Prompt

使用 CSP 组件管理智能卡 PIN 条目

选项AM_SMARTCARDPINENTRY=CSP
说明

使用 CSP 组件管理智能卡 PIN 条目。 默认情况下,向用户显示的 PIN 提示由 Citrix Receiver 而不是智能卡加密服务提供程序 (CSP) 提供。 Receiver 在需要时提示用户输入 PIN,然后将 PIN 传递给智能卡 CSP。 指定此属性可使用 CSP 组件管理 PIN 条目,包括提示输入 PIN。

示例用法CitrixReceiver.exe AM_SMARTCARDPINENTRY=CSP

使用 Kerberos

选项ENABLE_KERBEROS={Yes | No}
说明

默认值为 No。 指定 HDX 引擎是否应使用 Kerberos 身份验证,并仅在启用了单点登录(直通)身份验证时应用。 有关详细信息,请参阅配置使用 Kerberos 的域直通身份验证

示例用法CitrixReceiver.exe ENABLE_KERBEROS=No

显示旧 FTA 图标

选项LEGACYFTAICONS={False | True}
说明

使用此选项显示旧 FTA 图标。 默认值为 False。 指定是否为与订购的应用程序具有文件类型关联的文档显示应用程序图标。 如果此参数设置为 False,Windows 将为未向其分配特定图标的文档生成图标。 Windows 生成的图标由较小版本的应用程序图标覆盖的通用文档图标组成。 如果您计划向运行 Windows 7 的用户交付 Microsoft Office 应用程序,Citrix 建议启用此选项。

示例用法CitrixReceiver.exe LEGACYFTAICONS=False

启用预启动功能

选项ENABLEPRELAUNCH={False | True}
说明

默认值为 False。 有关会话预启动的信息,请参阅缩短应用程序启动时间

示例用法CitrixReceiver.exe ENABLEPRELAUNCH=False

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

选项STARTMENUDIR={Directory Name}
说明

默认情况下,应用程序显示在开始 > 所有程序下。 可以将程序文件夹下的相对路径指定为包含已订阅应用程序的快捷方式。 例如,要将快捷方式放置在“开始”>“所有程序”>“Receiver”下,请指定 STARTMENUDIR=\Receiver\。 用户可以随时更改文件夹名称或删除该文件夹。

还可以通过注册表项控制此功能:为 StartMenuDir 创建一个注册表项 REG_SZ,并将其值设置为 \相对路径。 位置:

HKLM\Software\[Wow6432Node\]Citrix\Dazzle

HKCU\Software\Citrix\Dazzle

对于通过指定了客户端应用程序文件夹(也称为 Program Neighborhood 文件夹)的 XenApp 发布的应用程序,可以按如下所述将客户端应用程序文件夹指定为附加到快捷方式路径:为 UseCategoryAsStartMenuPath 创建一个注册表项 REG_SZ,并将其值设置为 true。 使用如上所述的相同注册表位置。

注意:Windows 8/8.1 不允许在“开始”菜单中创建嵌入式文件夹。 “应用程序”将单独显示或在根文件夹下显示,不在通过 XenApp 定义的“类别”子文件夹中显示。

示例

  • 如果客户端应用程序文件夹为 \office,UseCategoryAsStartMenuPath 为 true,并且未指定 StartMenuDiris,则会将快捷方式放置在“开始”>“所有程序”>“Office”下。
  • 如果客户端应用程序文件夹为 \Office,UseCategoryAsStartMenuPath 为 true,StartMenuDir 为 \Receiver,则会将快捷方式放置在“开始”>“所有程序”>“Receiver”>“Office”下。

对这些设置所做的更改不会影响已创建的快捷方式。 要删除快捷方式,必须卸载并重新安装应用程序。

示例用法CitrixReceiver.exe STARTMENUDIR=\Office

指定应用商店名称

选项STOREx="storename;http[s]://servername.domain/IISLocation/discovery;[On | Off] ; [storedescription]" [ STOREy="..."]
说明

使用此选项可指定应用商店名称。 最多可以指定 10 个应用商店与 Citrix Receiver 结合使用。 值:

  • x 和 y – 整数 0 到 9。
  • storename – 默认值为 store。 此名称必须与在 StoreFront 服务器上配置的名称一致。
  • servername.domain – 托管应用商店的服务器的完全限定域名。
  • IISLocation – IIS 内的应用商店路径。 应用商店 URL 必须与 StoreFront 置备文件中的 URL 一致。 应用商店 URL 的格式为“/Citrix/store/discovery”。 要获取 URL,请从 Storefront 中导出一个置备文件,在记事本中打开,并复制 <Address> 元素中的 URL。
  • On | Off – 可选 Off 配置设置使您能够交付已禁用的应用商店,从而使用户能够选择是否访问这些应用商店。 如果应用商店状态未指定,则默认设置为 On。
  • storedescription – 应用商店的可选描述,例如 HR App Store。

注意:在本版本中,请务必在应用商店 URL 中包括 /discovery 以成功执行直通身份验证。

示例用法CitrixReceiver.exe STORE0="Store;https://test.xx.com/Citrix/Store/Discovery"

在用户设备上启用 URL 重定向

选项ALLOW_CLIENTHOSTEDAPPSURL=1
说明

在用户设备上启用 URL 重定向功能。 需要具有管理员权限。 需要为所有用户安装 Citrix Receiver。 有关 URL 重定向的信息,请参阅 XenDesktop 7 文档中的本地应用程序访问及其子主题。

示例用法CitrixReceiver.exe ALLOW_CLIENTHOSTEDAPPSURL=1

启用自助服务模式

选项SELFSERVICEMODE={False | True}
说明

默认值为 True。 如果管理员将 SelfServiceMode 标志设置为 False,用户将不再具有自助服务 Citrix Receiver 用户界面的访问权限。 相反,这些用户可以从“开始”菜单或通过桌面快捷方式(称为“仅快捷方式模式”)访问订阅的应用程序。

示例用法CitrixReceiver.exe SELFSERVICEMODE=False

指定桌面快捷方式的目录

选项DESKTOPDIR=<目录名称>
说明

将所有快捷方式放在单个文件夹中。 桌面快捷方式支持类别路径。

注意:使用 DESKTOPDIR 选项时,请将 PutShortcutsOnDesktop 注册表项设置为 True。

示例用法CitrixReceiver.exe DESKTOPDIR=\Office

从不受支持的 Citrix Receiver 版本进行升级

选项/rcu
说明

允许您将 Citrix Receiver 从不受支持的版本升级到最新版本。

示例用法CitrixReceiver.exe /rcu

在无人参与的安装期间显示安装完成对话框

安装完成时,将显示一个指示安装成功的对话框,然后显示添加帐户屏幕。 如果用户首次使用 Citrix Receiver for Windows,“添加帐户”对话框将要求您输入电子邮件或服务器地址以设置帐户。

对安装问题进行故障排除

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

CtxInstall-ICAWebWrapper-20141114-134516.log

TrolleyExpress-20090807-123456.log

命令行安装示例

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

CitrixReceiver.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"

指定单点登录(直通身份验证)并添加指向 XenApp Services URL 的应用商店:

CitrixReceiver.exe /INCLUDESSON /STORE0="PNAgent;https://testserver.net/Citrix/PNAgent/config.xml;on;My PNAgent Site"

从命令行启动虚拟桌面或应用程序

Citrix Receiver for Windows 会为每个已订阅的桌面或应用程序创建存根应用程序。 您可以使用存根应用程序从命令行启动虚拟桌面或应用程序。 存根应用程序位于 %appdata%\Citrix\SelfService 中。 存根应用程序的文件名即为应用程序的显示名称(删除其中的空格)。 例如 Internet Explorer 的存根应用程序文件名为 InternetExplorer.exe。