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

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

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

要从命令提示窗口中安装适用于 Windows 的 Citrix Workspace 应用程序,请使用以下语法:

CitrixWorkspaceApp.exe [选项]

Workspace 更新

选项 /AutoUpdateCheck = auto/manual/disabled
说明 指示 Citrix Workspace 应用程序在有可用更新时进行检测。自动 - 系统将在有可用更新时向您发出通知(默认设置);手动 - 系统在有更新可用时不向您发出通知。手动检查更新;已禁用 - 禁用自动更新
示例用法 CitrixWorkspaceApp.exe /AutoUpdateCheck = auto ; CitrixWorkspaceApp.exe /AutoUpdateCheck = manual ; CitrixWorkspaceApp.exe /AutoUpdateCheck = disabled
选项 /AutoUpdateStream= LTSR/Current
说明 指示 Citrix Workspace 应用程序的版本;LTSR - 指示版本为长期服务版本;当前 - 指示版本为最新版本的 Citrix Workspace 应用程序
示例用法 CitrixWorkspaceApp.exe /AutoUpdateStream= LTSR ; CitrixWorkspaceApp.exe /AutoUpdateStream= Current
选项 /DeferUpdateCount
说明 指示 Citrix Workspace 应用程序的版本。-1 - 指示您可以将通知推迟任意次数(默认值 = -1); 0 - 指示不显示“以后提醒我”选项。任何其他数值 - 指示显示“以后提醒我”选项该次数。例如,如果将该值设置为 10,以后提醒我选项将显示 10 次。
示例用法 CitrixWorkspaceApp.exe /DeferUpdateCount=-1 ; CitrixWorkspaceApp.exe /DeferUpdateCount=-0 ; CitrixWorkspaceApp.exe /DeferUpdateCount=任何其他数值
选项 /AURolloutPriority
说明 指示您可以暂缓推出更新的期限。Fast - 在交付期限的初期推出更新。Medium - 在交付期限的中期推出更新。Slow - 在交付期限的末期推出更新。
示例用法 CitrixWorkspaceApp.exe /AURolloutPriority=Fast ; CitrixWorkspaceApp.exe /AURolloutPriority=Medium ; CitrixWorkspaceApp.exe /AURolloutPriority=Slow

启用双向内容重定向

注意

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

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

隐藏设置选项

   
选项 /DisableSetting
说明 禁止“快捷方式和重新连接”选项显示在“高级首选项”表中。
示例用法 CitrixWorkspaceApp.exe /DisableSetting=3
   
如果希望在“快捷方式和重新连接”选项中同时显示“应用程序显示”和“重新连接选项”。 输入 CitrixWorkspaceApp.exe /DisableSetting=0
如果希望在“高级首选项”表中隐藏“快捷方式和重新连接”选项 输入 CitrixWorkspaceApp.exe /DisableSetting=3
如果希望“快捷方式和重新连接”选项仅显示“应用程序显示” 输入 CitrixWorkspaceApp.exe /DisableSetting=2
如果希望“快捷方式和重新连接”选项仅显示“重新连接选项” 输入 CitrixWorkspaceApp.exe /DisableSetting=1

启用本地应用程序访问

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

显示使用信息

选项 /? 或 /help
说明 指示用法信息
示例用法 CitrixWorkspaceApp.exe /? ; CitrixWorkspaceApp.exe /help

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

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

无提示安装

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

启用单点登录身份验证

选项 /includeSSON
说明 指示 Citrix Workspace 应用程序将随 Single Sign-On 组件安装。相关选项 ENABLE_SSON 在命令行中包含 /includeSSON 时启用。如果要使用 ADDLOCAL= 指定各项功能,并希望安装单点登录,还必须指定值 SSON。要为用户设备启用直通身份验证,必须从包含选项 /includeSSON 的命令行使用本地管理员权限安装 Citrix Workspace 应用程序。有关详细信息,请参阅“How to Manually install and configure Citrix Workspace for Pass-through Authentication”(如何手动安装和配置 Citrix Workspace 以实现直通身份验证)。注意: 智能卡、Kerberos 以及本地用户名和密码策略相互依赖。配置顺序非常重要。建议首先禁用不需要的策略,然后启用所需的策略。请仔细验证结果。
示例用法 CitrixWorkspaceApp.exe /includeSSON

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

选项 ENABLE_SSON={Yes, No}
说明 在指定了 /includeSSON 时启用单点登录。默认值为 Yes。智能卡单点登录需要此属性。在启用了单点登录身份验证的情况下安装之后,用户必须注销并重新登录其设备。需要具有管理员权限。
示例用法 CitrixWorkspaceApp.exe ENABLE_SSON=Yes

AlwaysOn 跟踪

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

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

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

指定安装目录

选项 INSTALLDIR=安装目录
说明 指定安装了大多数 Citrix Workspace 应用程序的安装路径。默认值为 C:\Program Files\Citrix\Workspace。以下 Citrix Workspace 组件将安装在路径 C:\Program Files\Citrix 中:身份验证管理器Citrix Workspace自助服务插件。如果您使用此选项并指定了一个安装目录,则必须在 \Workspace 目录中安装 RIInstaller.msi 文件,在安装目录中安装其他 .msi 文件。
示例用法 CitrixWorkspaceApp.exe INSTALLDIR=c:\Citrix\Test

识别用户设备

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

动态客户端名称

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

安装指定的组件

选项 ADDLOCAL=
说明 alt_text
示例用法 CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,AM,SELFSERVICE,DesktopViewer,Flash,Vd3d,WebHelper,BrowserEngine, WorkspaceHub

配置适用于 Windows 的 Workspace 以手动添加应用商店

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

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

选项 ALLOWSAVEPWD={N, S, A}
说明 默认值为 PNAgent 服务器在运行时指定的值。指定用户是否能够将应用商店的凭据本地保存在自己的计算机上,并且仅适用于使用 PNAgent 协议的应用商店。默认值为 S。选项包括:N – 不允许用户保存密码。S - 允许用户保存安全应用商店 (HTTPS) 和非安全应用商店 (HTTP) 的密码。也可以通过更新注册表项 HKEY_LOCAL_MACHINE\Software[Wow6432Node]\Citrix\Dazzle\AllowSavePwd 控制此功能。注意: 如果 AllowSavePwd 不起作用,则必须手动添加以下注册表项:1 注册表项(适用于 32 位操作系统客户端):HKEY_LOCAL_MACHINE\Software\Citrix\AuthManager 2 注册表项(适用于 64 位操作系统客户端):HKEY_LOCAL_MACHINE\Software\wow6432node\Citrix\AuthManager 3 类型: REG_SZ 4 值: never - 绝不允许用户保存密码。secureonly - 仅允许用户保存安全应用商店的密码(配置了 HTTPS)。always - 允许用户保存安全应用商店 (HTTPS) 和非安全应用商店 (HTTP) 的密码。
示例用法 CitrixWorkspaceApp.exe ALLOWADDSTORE=N

选择证书

选项 AM_CERTIFICATESELECTIONMODE={Prompt, SmartCardDefault, LatestExpriry }
说明 alt_text
示例用法 CitrixWorkspaceApp.exe AM_CERTIFICATESELECTIONMODE=Prompt

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

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

使用 Kerberos

选项 ENABLE_KERBEROS={Yes , No}
说明 默认值为“否”。指定 HDX 引擎是否应使用 Kerberos 身份验证,并仅在启用了单点登录(直通)身份验证时应用。有关详细信息,请参阅“配置使用 Kerberos 的域直通身份验证”。
示例用法 CitrixWorkspaceApp.exe ENABLE_KERBEROS=No

显示旧 FTA 图标

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

启用预启动功能

选项 ENABLEPRELAUNCH={False, True}
说明 默认值为 False。有关会话预启动的信息,请参阅缩短应用程序启动时间。
示例用法 CitrixWorkspaceApp.exe ENABLEPRELAUNCH=False

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

选项 STARTMENUDIR={Directory Name}
说明 默认情况下,应用程序显示在开始 > 所有程序下。可以指定程序文件夹中的快捷方式的相对路径。例如,要将快捷方式放置在“开始”>“所有程序”>“Workspace”下,请指定 STARTMENUDIR=\Workspace。可以随时更改或移动文件夹。还可以使用注册表项控制此功能:为 StartMenuDir 创建一个注册表项 REG_SZ,并将其值设置为“\RelativePath” 位置:HKEY_LOCAL_MACHINE\Software[Wow6432Node]Citrix\Dazzle ,HKEY_CURRENT_USER\Software\Citrix\Dazzle. 对于通过指定了客户端应用程序文件夹(也称为 Program Neighborhood 文件夹)的 Citrix Virtual Apps 发布的应用程序,可以按如下所述指定客户端应用程序文件夹将附加到快捷方式路径:为 UseCategoryAsStartMenuPath 创建一个注册表项 REG_SZ,并将其值设置为 true。使用如上所述的相同注册表位置。注意: Windows 8/8.1 不允许您在“开始”菜单中创建嵌入式文件夹。“应用程序”将单独显示或在根文件夹中显示,不在定义的“类别”子文件夹中显示。示例:1 如果客户端应用程序文件夹为 \office,UseCategoryAsStartMenuPath 为 true,并且未指定 StartMenuDiris,则会将快捷方式放置在“开始”>“所有程序”>“Office”下。2 如果客户端应用程序文件夹为 \Office,UseCategoryAsStartMenuPath 为 true,StartMenuDir 为 \Workspace,则会将快捷方式放置在“开始”>“所有程序”>“Workspace”>“Office”下。对这些设置所做的更改不会影响已创建的快捷方式。必须卸载并重新安装应用程序,才能移动快捷方式
示例用法 CitrixWorkspaceApp.exe STARTMENUDIR=\Office

指定应用商店名称

选项 STOREx=”storename;http[s]://servername.domain/IISLocation/discovery;[On, Off] ; [storedescription] “[STOREy=”–”]
说明 使用此选项可指定应用商店名称。最多可以指定 10 个应用商店与适用于 Windows 的 Workspace 结合使用。值: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 以成功执行直通身份验证。
示例用法 CitrixWorkspaceApp.exe STORE0=”Store;https://test.xx.com/Citrix/Store/Discovery

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

选项 ALLOW_CLIENTHOSTEDAPPSURL=1
说明 在用户设备上启用 URL 重定向功能。需要具有管理员权限。需要为所有用户安装适用于 Windows 的 Workspace。有关 URL 重定向的信息,请参阅 Citrix Virtual Apps and Desktops 文档中的“本地应用程序访问”及其子主题。
示例用法 CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=1

启用自助服务模式

选项 SELFSERVICEMODE={False , True}
说明 默认值为 True。如果管理员将 SelfServiceMode 标志设置为 false,用户将不再具有自助服务适用于 Windows 的 Workspace 用户界面的访问权限。相反,这些用户可以从“开始”菜单或通过桌面快捷方式(称为仅快捷方式模式)访问订阅的应用程序。
示例用法 CitrixWorkspaceApp.exe SELFSERVICEMODE=False

指定桌面快捷方式的目录

选项 DESKTOPDIR=目录名称
说明 将所有快捷方式放在单个文件夹中。桌面快捷方式支持类别路径。注意: 使用 DESKTOPDIR 选项时,请将 PutShortcutsOnDesktop 注册表项设置为 True。
示例用法 CitrixWorkspaceApp.exe DESKTOPDIR=\Office

从不受支持的 Citrix Workspace 应用程序版本进行升级

注意

使用图形用户界面将 Citrix Workspace 应用程序 13.x Enterprise 或 12.x 升级到 Citrix Workspace 应用程序 4.4 及更高版本时,默认情况下,安装程序将运行 Receiver 清理实用程序。

但是,从命令行升级时,该实用程序默认不运行。要从命令行升级,请运行以下命令:

CitrixWorkspaceApp.exe /rcu /silent

将 Citrix Receiver for Windows 从 13.x(非 Enterprise)或 4.1 升级到 4.2 或更高版本时,/rcu 开关是不必要的,将被忽略。

选项 /rcu
说明 允许您将 Citrix Workspace 从不受支持的版本升级到最新版本。
示例用法 CitrixWorkspaceApp.exe /rcu

对安装问题进行故障排除

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

CtxInstall-ICAWebWrapper-20141114-134516.log

TrolleyExpress-20090807-123456.log

命令行安装示例

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

CitrixWorkspaceApp.exe STORE0="<StoreFriendlyName>;[testserver](https://testserver.com) <StoreName>;<On/Off>;<StoreDescription>"]

注意

Citrix Gateway 应用商店 URL 必须是已配置的应用商店 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"

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

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

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

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