Product Documentation

使用命令行参数配置和安装

Feb 26, 2018

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

有关空间要求的详细信息,请参阅系统要求

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

CitrixReceiver.exe [Options]

Receiver 更新

选项 /AutoUpdateCheck = auto/manual/disabled
说明 指示 Citrix Receiver for Windows 在有可用更新时进行检测。
  • 自动 – 系统将在有可用更新时向您发出通知(默认设置)。
  • 手动 – 系统在有可用更新时不向您发出通知。手动检查更新。
  • 已禁用 – 禁用自动更新
示例用法

CitrixReceiver.exe /AutoUpdateCheck = auto

CitrixReceiver.exe /AutoUpdateCheck = manual

CitrixReceiver.exe /AutoUpdateCheck = disabled

选项

/AutoUpdateStream= LTSR/Current

说明

指示 Citrix Receiver for Windows 的版本。
  • LTSR – 指示版本为长期服务版本
  • 当前 – 指示版本为最新版本的 Citrix Receiver for Windows

示例用法

CitrixReceiver.exe /AutoUpdateStream= LTSR

CitrixReceiver.exe /AutoUpdateStream=LTSR

选项

/DeferUpdateCount

说明

指示显示以后提醒我选项的次数。指示您可以将更新退出设置的次数。
  • -1 – 指示您可以将通知推迟任意次数(默认值 = -1)。
  • 0 – 指示不显示以后提醒我选项。
  • 任何其他数值 – 指示显示以后提醒我选项该次数。例如,如果将该值设置为 10,以后提醒我选项将显示 10 次。

示例用法

CitrixReceiver.exe /DeferUpdateCount=-1

CitrixReceiver.exe /DeferUpdateCount=-0

CitrixReceiver.exe /DeferUpdateCount=<任何其他数值>

选项

/AURolloutPriority

说明

指示您可以暂缓推出更新的期限。
  • 快 – 在交付期限的初期推出更新。
  • 中 – 在交付期限的中期推出更新。
  • 慢 – 在交付期限的末期推出更新。

示例用法

CitrixReceiver.exe /AURolloutPriority=Fast

CitrixReceiver.exe /AURolloutPriority=Medium

CitrixReceiver.exe /AURolloutPriority=Slow

启用双向内容重定向

注意

默认情况下,如果已在服务器上安装双向内容重定向组件,Citrix Receiver for Windows 将不安装这些组件。如果使用 XenDesktop 作为客户端计算机,则必须使用 /FORCE_LAA 开关安装双向内容重定向组件,从而安装 Citrix Receiver for Windows。但是,必须在服务器和客户端上配置该功能。

选项 ALLOW_BIDIRCONTENTREDIRECTION=1
说明 指示在客户端到主机与主机到客户端之间已启用双向内容重定向。
示例用法 CitrixReceiver.exe /ALLOW_BIDIRCONTENTREDIRECTION=1

隐藏设置选项

选项

/DisableSetting

说明

禁止“设置选项”显示在“高级首选项”对话框中。

示例用法

CitrixReceiver.exe /DisableSetting=3

如果想在“设置选项”中同时显示“应用程序显示”和“重新连接选项”。

输入 CitrixReceiver.exe /DisableSetting=0

如果想在“高级首选项”对话框中隐藏“设置选项”

输入 CitrixReceiver.exe /DisableSetting=3

如果希望“设置选项”仅显示“应用程序显示”

输入 CitrixReceiver.exe /DisableSetting=2

如果希望“设置选项”仅显示“重新连接选项”

输入 CitrixReceiver.exe /DisableSetting=1

启用本地应用程序访问

选项 FORCE_LAA=1
说明 默认情况下,如果已在服务器上安装客户端本地应用程序访问组件,Citrix Receiver for Windows 将不安装这些组件。要强制在 Citrix Receiver 上安装客户端本地应用程序访问组件,请使用 FORCE_LAA 命令行开关。
需要管理员级别的权限才能执行这些步骤。
有关本地应用程序访问的详细信息,请参阅 XenApp 和 XenDesktop 文档中的本地应用程序访问
示例用法

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
说明

指示 Citrix Receiver for Windows 将随单点登录组件安装。

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

要为用户设备启用直通身份验证,必须从包含选项 /includeSSON 的命令行通过本地管理员权限安装 Citrix Receiver for Windows。有关详细信息,请参阅如何手动安装和配置 Citrix Receiver 以实现直通身份验证

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

示例用法 CitrixReceiver.exe /includeSSON

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

选项 ENABLE_SSON={Yes | No}。
说明

在指定了 /includeSSON 时启用单点登录。默认值为 Yes。智能卡单点登录需要此属性。
请注意,在启用了单点登录身份验证的情况下安装之后,用户必须注销并重新登录其设备。需要具有管理员权限。

示例用法 CitrixReceiver.exe ENABLE_SSON=Yes

AlwaysOn 跟踪

选项 /EnableTracing={true | false}
说明
默认情况下,此功能设置为 true。
使用此属性可明确启用或禁用 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 ENABLE_DYNAMIC_CLIENT_NAME =Yes

安装指定的组件

选项 ADDLOCAL=
说明

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

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}
说明

默认值为 PNAgent 服务器在运行时指定的值。指定用户是否能够将应用商店的凭据本地保存在自己的计算机上,并且仅适用于使用 PNAgent 协议的应用商店。默认值为 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}
说明

默认值为“否”。指定 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 中导出一个置备文件,在记事本中打开,并复制 元素中的 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

对安装问题进行故障排除

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

CtxInstall-ICAWebWrapper-20141114-134516.log

TrolleyExpress-20090807-123456.log

命令行安装示例

要指定 NetScaler Gatewaya 应用商店 URL,请执行以下操作:

CitrixReceiver.exe STORE0=";https://testserver.com#;;"

注意:NetScaler Gateway 应用商店 URL 必须是已配置的应用商店 URL 列表中的第一个条目。

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

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。