Product Documentation

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

Nov 19, 2015

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

Citrix Receiver 4.2 for Windows 下载

警告:注册表编辑器如果使用不当,会导致可能需要重新安装操作系统的严重问题。Citrix 无法保证因“注册表编辑器”使用不当导致出现的问题能够得以解决。使用“注册表编辑器”需自担风险。请确保在编辑注册表之前进行备份。

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

CitrixReceiver.exe [选项]

选项包括:

  • /?/help 显示使用信息。
  • /noreboot 禁止在 UI 安装期间重新启动。无提示安装不需要此选项。如果您禁止显示重新启动提示,Receiver 安装时处于暂停状态的任何 USB 设备在重新启动用户设备后才能被 Receiver 识别。
  • /silent 禁用错误和进度对话框,以执行完全无提示安装。另请参阅 /noreboot。
  • /includeSSON 安装单点登录(直通)身份验证。智能卡单点登录需要此选项。

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

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

    本地用户名和密码

    启用直通身份验证

    允许对所有 ICA 执行直通身份验证(可能需要,具体取决于 Web Interface 配置和安全设置)

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

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

    其中 PROPERTY 为通过 Value 指定的以下全大写变量之一。

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

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

    • CLIENT_NAME=ClientName,其中 ClientName 是服务器场用来识别用户设备的名称。默认值为 %COMPUTERNAME%
    • ENABLE_DYNAMIC_CLIENT_NAME={Yes | No} 动态客户端名称功能可以使客户端名称始终与计算机名称相同。当用户更改其计算机名称时,客户端名称会随之相应更改。默认为 Yes。要显示动态客户端名称支持,请将此属性设置为 No,并为 CLIENT_NAME 属性指定一个值。
    • ADDLOCAL=feature[,...] 安装一个或多个指定组件。指定多个参数时,请用逗号分隔每个参数,并且参数之间不能有空格。名称区分大小写。如果未指定此参数,则默认安装所有组件。
      注意:ReceiverInside 和 ICA_Client 是所有其他组件的必备项,必须安装。

      ReceiverInside – 安装 Receiver Experience。(Receiver 操作的必要组件。)

      ICA_Client – 安装 Receiver (standard)。(Receiver 操作的必要组件。)

      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 及更高版本中可用参数列表的信息,请参阅 http://support.citrix.com/article/CTX200337

      自助服务插件允许用户从 Receiver 窗口或命令行访问虚拟桌面和应用程序,如本部分后面的从命令行启动虚拟桌面或应用程序中所述。

      USB – 安装 USB 支持功能。需要具有管理员权限。

      DesktopViewer – 安装 Desktop Viewer。

      Flash – 安装 HDX Media Stream for Flash。

      Vd3d – 启用 Windows Aero 体验(面向支持此功能的操作系统)。

    • ALLOWADDSTORE={N | S | A} – 指定用户是否可以添加和删除未通过 Merchandising Server 产品配置的应用商店。(用户可以启用或禁用通过 Merchandising Server 交付配置的应用商店,但无法删除这些应用商店或更改其名称或 URL。)默认值为 S

      N – 不允许用户添加或删除自己的应用商店。

      S – 仅允许用户添加或删除安全应用商店(已配置 HTTPS)。

      A – 允许用户添加或删除安全应用商店 (HTTPS) 和非安全应用商店 (HTTP)。如果 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. 退出并重新启动 Receiver。
    • ALLOWSAVEPWD={N | S | A} – 默认值为在运行时从 PNAgent 服务器指定的值。指定用户是否能够将应用商店的凭据本地保存在自己的计算机上,且仅适用于使用 PNAgent 协议的应用商店。

      N – 不允许用户保存密码。

      S – 仅允许用户保存安全应用商店的密码(已配置 HTTPS)。

      A – 允许用户保存安全应用商店 (HTTPS) 和非安全应用商店 (HTTP) 的密码。

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

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

      32 位操作系统客户端的注册表项:HKLM\Software\Citrix\AuthManager

      64 位操作系统客户端的注册表项:HKLM\Software\wow6432node\Citrix\AuthManager

      名称:SavePasswordMode

      类型:REG_SZ

      值:never – 绝不允许用户保存密码。secureonly – 仅允许用户保存安全应用商店的密码(通过 HTTPS 配置)。always – 允许用户保存安全应用商店 (HTTPS) 和不安全应用商店 (HTTP) 的密码。
    • ENABLE_SSON={Yes | No} – 默认值为 Yes。在同时指定了 /includeSSON 时启用单点登录。智能卡单点登录需要此属性。请注意,启用带有单点登录身份验证的安装之后,用户必须注销并重新登录其设备。需要具有管理员权限。
      重要:如果您禁用后重新启用了 Single Sign-On 身份验证,用户必须重新安装 Receiver。
    • AM_CERTIFICATESELECTIONMODE={ Prompt | SmartCardDefault | LatestExpiry } – 默认值为 Prompt,该值将提示用户从列表中选择一个证书。更改此属性可选择默认证书(根据智能卡提供商)或近期即将过期的证书。如果没有有效的登录证书,则会向用户发出通知,并提供使用其他可用登录方法的选项。

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

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

      还可以通过注册表项 HKLM\Software\[Wow6432Node\]Citrix\AuthManager: SmartCardPINEntry=CSP 控制此功能。

    • ENABLE_KERBEROS={Yes | No} – 默认值为 No。指定 HDX 引擎是否应使用 Kerberos 身份验证,并仅在启用了单点登录(直通)身份验证时应用。有关详细信息,请参阅配置使用 Kerberos 的域直通身份验证
    • LEGACYFTAICONS={False | True} – 默认值为 False。指定是否为与订购的应用程序具有文件类型关联的文档显示应用程序图标。如果此参数设置为 False,Windows 将为未向其分配特定图标的文档生成图标。Windows 生成的图标由较小版本的应用程序图标覆盖的通用文档图标组成。如果您计划向运行 Windows 7 的用户交付 Microsoft Office 应用程序,Citrix 建议启用此选项。
    • ENABLEPRELAUNCH={False | True} – 默认值为 False。有关会话预启动的信息,请参阅缩短应用程序启动时间
    • STARTMENUDIR=文本字符串 – 默认情况下,应用程序显示在“开始”>“所有程序”下。可以将程序文件夹下的相对路径指定为包含已订阅应用程序的快捷方式。例如,要将快捷方式放置在“开始”>“所有程序”>“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 定义的“类别”子文件夹中显示。

      示例:如果客户端应用程序文件夹\OfficeUseCategoryAsStartMenuPathtrue,并且未指定 StartMenuDir,则会将快捷方式放置在“开始”>“所有程序”>“Office”下。示例:如果客户端应用程序文件夹\OfficeUseCategoryAsStartMenuPathtrueStartMenuDir\Receiver,则会将快捷方式放置在“开始”>“所有程序”>“Receiver”>“Office”下。

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

    • STOREx="storename;http[s]://servername.domain/IISLocation/discovery;[On | Off];[storedescription]"[ STOREy="..."] – 最多指定 10 个应用商店用于 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 以成功执行直通身份验证。
      • ALLOW_CLIENTHOSTEDAPPSURL=1 - 在用户设备上启用 URL 重定向功能。需要具有管理员权限。需要为所有用户安装 Receiver。有关 URL 重定向的信息,请参阅 XenDesktop 7 文档中的本地应用程序访问及其子主题。
      • SELFSERVICEMODE={False | True} - 默认值为 True。如果管理员将 SelfServiceMode 标志设置为 False,用户将不再具有自助服务 Receiver 用户界面的访问权限。相反,这些用户可以从“开始”菜单或通过桌面快捷方式(称为“仅快捷方式模式”)访问订阅的应用程序。请参阅配置仅快捷方式模式以了解详细信息。
      • DESKTOPDIR=Dir_Name。将所有快捷方式放在单个文件夹中。桌面快捷方式支持类别路径。
        注意: DESKTOPDIR 要求将PutShortcutsOnDesktop键设置为 True。请参阅配置仅快捷方式模式以了解详细信息。
      • 在无人参与的安装期间显示安装完成对话框

        对于无人参与的 CitrixReceiver.exe 安装,安装完成之前会对首次使用的用户显示“添加帐户”对话框。“添加帐户”对话框要求用户输入电子邮件或服务器地址才能完成安装。要使用安装完成时显示的内容替换“添加帐户”对话框并允许用户选择设置帐户,请将以下注册表项值添加到注册表项 HKCU\Software\Citrix\Receiver and HKCU\Software\Policies\Citrix 中:EnableFTU=0。

        如果多个用户登录到同一计算机,将相同的注册表项添加到计算机范围内的策略中。

        注意:如果未通过上述 STOREx 参数或组策略对象配置常用应用商店,之前尚未登录安装了 Receiver 的计算机的用户可能会看到“添加帐户”对话框。要取消显示此对话框,请在注册表项 HKCU\Software\Citrix\Receiver or HKCU\Software\Policies\Citrix 中创建一个 REG_DWORD 值 EnableFTU 并将其值设置为0.

        对安装问题进行故障排除

        如果安装出现问题,请在用户的 %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"

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

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