使用命令行安装

重要的是:

如果您正在升级，并且您当前的版本使用或安装了Personal VDisk或AppDisks软件，请参阅删除pvd，appdisks和不支持的主机．

介绍

本文适用于在具有Windows操作系统的机器上安装组件。Linux操作系统vda的相关信息请参见Linux虚拟交付代理．

本文介绍如何发出产品安装命令。在开始任何安装之前，检查准备安装．这篇文章包括对可用安装程序的描述。

要查看命令执行进度和返回值，您必须是原始管理员或用户以管理员身份运行．有关更多信息，请参见Microsoft命令文档。

作为直接使用安装命令的补充，产品ISO上提供了示例脚本，用于在Active Directory中的计算机上安装、升级或删除VDA。有关详细信息，请参阅使用脚本安装VDAs．

如果您试图在本Citrix虚拟应用程序和桌面版本不支持的Windows操作系统版本上安装或升级，则会有一条消息引导您了解有关选项的信息。看到早期的操作系统．

有关Citrix如何报告组件安装结果的信息，请参见Citrix安装返回码．

使用完整产品安装程序

要访问完整的产品安装程序的命令行界面：

1. 从Citrix下载产品包。访问下载站点需要Citrix帐户凭证。
2. 解压文件。可选地，刻录ISO文件的DVD。
3. 使用本地管理员帐户登录到正在安装组件的服务器。
4. 将光盘插入光驱或挂载ISO文件。

5. 从\ x64 \ XenDesktop设置在介质上的目录中，运行相应的命令。

   安装核心组件:运行XenDesktopServerSetup.exe，列出的选项用于安装核心组件的命令行选项．

   要安装VDA，请执行以下操作：运行xendesktopvdasetup.exe.中列出的选项用于安装VDA的命令行选项．

   安装店面:运行CitrixStoreFront-x64.exe在x64 >店面安装介质上的文件夹。

   安装Universal Print Server:遵循指导用于安装通用打印服务器的命令行选项．

   安装联邦身份验证服务:Citrix建议使用图形界面。

   安装会话录音:遵循指导会议记录．

使用独立的VDA安装程序

访问下载站点需要Citrix帐户凭证。在开始安装之前，您必须具有较高的管理权限，或者使用以管理员身份运行．

1. 从Citrix下载相应的软件包:
   • 多项会话操作系统虚拟交付代理：VDAServerSetup.exe
   • 单会话OS虚拟交付代理:VDAWorkstationSetup.exe
   • 单会话操作系统核心服务虚拟交付代理：VDAWorkstationResetUp.exe

2. 要么先将包中的文件解压缩到现有目录中，然后运行安装命令，要么直接运行包。

   要在安装之前提取文件，请使用/提取以绝对路径为例。\ VDAWorkstationCoreSetup.exe /提取%临时% \ CitrixVDAInstallMedia．目录必须存在。否则，提取物失败。然后在单独的命令中使用本文中列出的有效选项运行相应的命令。

   • 为了VDAServerSetup_XXXX.exe、运行\extract\Image Full\x64\XenDesktop安装程序\XenDesktopVDASetup.exe

   • 为了VDAWorkstationCoreSetup_XXXX.exe、运行< >提取文件夹\ \ Image-Full提取\ x64 \ \ XenDesktopRemotePCSetup.exe XenDesktop设置

   • 为了VDAWorkstationSetup_XXXX.exe、运行\extract\Image Full\x64\XenDesktop安装程序\XenDesktopVDASetup.exe

   要运行下载的包，请运行其名称：VDAServerSetup.exe那VDAWorkstationSetup.exe,或VDAWorkstationResetUp.exe．使用本文中列出的有效选项。

如果您熟悉完整的产品安装程序：

• 运行独立的VDAServerSetup.exe或VDAWorkstationSetup.exe安装程序，就好像它是XenDesktopVdaSetup.exe除了名字之外，其他的都是命令。

• 这VDAWorkstationResetUp.exe安装程序是不同的，因为它支持其他安装程序可用选项的子集。

用于安装核心组件的命令行选项

使用安装核心组件时，以下选项有效XenDesktopServerSetup.exe命令。有关选项的更多详细信息，请参阅安装核心组件．

• /组成部分成分[，成分)……

  要安装或删除的组件的逗号分隔列表。有效值为：

  • 控制器:控制器
  • Desktopstudio:工作室
  • 桌面控制器：导演
  • 许可证: Citrix License Server

  如果省略此选项，则安装所有组件(如果/除去选项)。

  (在2003年以前的版本中，包含有效值店面．对于版本2003及更高版本，请使用提到的专用店面安装命令使用完整产品安装程序)．

• /配置防火墙

  如果Windows firewall Service运行，即使没有开启防火墙，也会打开所安装组件使用的Windows防火墙的所有端口。如果您正在使用第三方防火墙或没有防火墙，则必须手动打开端口。

• / disableexperiencemetrics

  防止在安装，升级或拆除到Citrix期间收集的自动上传分析。

• /排除“特色”[,”特色”]

  防止安装一个或多个用逗号分隔的特性、服务或技术，每个特性、服务或技术都用直接的引号括起来。有效值:

  • “本地主机缓存存储（localDB）”:防止安装本地主机缓存所使用的数据库。此选项对是否安装SQL Server Express作为站点数据库没有影响。

• /帮助或/小时

  显示命令帮助。

• / ignore_hw_check_failure

  允许继续安装或升级Delivery Controller，即使硬件检查失败(例如，由于RAM不足)。有关更多信息，请参见硬件检查．

• / ignore_site_test_failure

  仅在升级Controller时有效。通常，任何站点测试失败都会被忽略，升级会继续进行。如果省略(或设置为false)，任何站点测试失败都会导致安装程序失败，而不执行升级。默认= false

  在升级过程中，如果检测到不支持的SQL Server版本，则忽略此选项。有关详细信息，请参阅SQL Server版本检查．

• / installdir目录

  将安装组件的现有空目录。默认= C：\ Program Files \ Citrix。

• / logpath.小路

  日志文件的位置。指定的文件夹必须存在。安装程序不会创建它。默认=临时% \ Citrix \ XenDesktop安装程序

• / no_pending_reboot_check

  安装或升级核心组件时，防止检查计算机上以前安装的Windows是否有挂起的重新启动。

• / no_remote_assistance

  仅在安装Director时有效。禁用使用Windows远程协助的用户阴影特性。

• / noreboot

  防止安装后重新启动。（对于大多数核心组件，默认情况下未启用重启。）

• / noresume

  默认情况下，当安装过程中需要重新启动机器时，安装程序将在重新启动完成后自动恢复。若要覆盖默认值，请指定/ noresume。如果您必须重新安装媒体或希望在自动安装过程中捕获信息，这将非常有用。

• /nosql

  防止在安装控制器的服务器上安装Microsoft SQL Server Express。如果省略此选项，则安装SQL Server Express以用作站点数据库。

  此选项对用于本地主机缓存的SQL Server Express LocalDB的安装没有影响。

• /安静或/被动

  安装过程中没有出现用户界面。安装过程的唯一证据是在Windows任务管理器中。如果省略此选项，则图形界面启动。

• /除去

  属性指定的核心组件/组成部分选项

• / removeall

  删除所有已安装的核心组件。

• / sendexperiencemetrics

  自动将安装、升级或删除过程中收集的分析信息发送给Citrix。如果省略此选项（或/ disableexperiencemetrics指定），分析在本地收集，但不会自动发送。

• / tempdir.目录

  存放安装期间临时文件的目录。默认= c:\Windows\Temp.

• / Xenapp.

  安装Citrix虚拟应用。如果省略此选项，则安装Citrix Virtual Apps和desktop。

安装核心组件的示例

下面的命令将在服务器上安装Delivery Controller、Studio、Citrix Licensing和SQL Server Express。组件通信所需的防火墙端口自动打开。

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall . x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

下面的命令在服务器上安装Citrix Virtual Apps Controller、Studio和SQL Server Express。组件通信所需的防火墙端口自动打开。

\ x64 \ xendesktop setup \\ XenDesktopserversetup.exe / XenApp / Companionsert，Desktopstudio / configure_firewall

用于安装VDA的命令行选项

以下选项对下列命令(安装程序)中的一个或多个是有效的:xendesktopvdasetup.exe.那VDAWorkstationSetup.exe,VDAWorkstationResetUp.exe．

有关选项的更多详细信息，请参阅安装VDA.．

• /组成部分成分[，成分]

  要安装或删除的组件的逗号分隔列表。有效值为：

  • VDA:虚拟快递代理
  • 插件：适用于Windows的Citrix工作区应用程序

  要安装Windows的VDA和Citrix工作区应用程序，请指定/组件的共识,插件．

  如果省略此选项，则只安装了VDA(而不是Citrix Workspace应用程序)。

  使用时，此选项无效VDAWorkstationResetUp.exe安装程序。安装程序无法安装Citrix工作区应用程序。

• /控制器“控制器[控制器]”

  VDA可以与之通信的控制器的空格分隔FQDN，用直引号括起来。不要同时指定/ site_guid.和/控制器选项。

• / disableexperiencemetrics

  防止在安装，升级或删除到Citrix期间收集的自动上传分析。

• / enable_hdx_ports

  如果检测到Windows防火墙服务，即使没有启用防火墙，也会在VDA所需的Windows防火墙中打开端口，并启用特性(Windows远程协助除外)。如果您正在使用不同的防火墙或没有防火墙，则必须手动配置防火墙。端口信息请参见网络港口．

  要打开HDX自适应传输使用的UDP端口，指定/启用\u hdx\u udp\u端口选项，除此之外/ enable_hdx_ports选项

• /启用\u hdx\u udp\u端口

  打开HDX自适应传输使用的Windows防火墙中的UDP端口，如果检测到Windows防火墙服务，即使防火墙没有启用。如果您正在使用不同的防火墙或没有防火墙，则必须手动配置防火墙。端口信息请参见网络港口．

  要打开VDA使用的额外端口，请指定/ enable_hdx_ports选项，除此之外/启用\u hdx\u udp\u端口选项

• / enable_real_time_transport.

  启用或禁用UDP音频包(RealTime音频传输)的使用。启用此功能可以提高音频性能。包括/ enable_hdx_ports选项，如果您希望在检测到Windows防火墙服务时自动打开UDP端口。

• /启用远程协助

  启用Windows远程帮助中的阴影功能与导演一起使用。如果指定此选项，Windows远程协助将打开防火墙中的动态端口。

• /启用还原或/ enablerestorecleanup

  (仅对单会话VDA有效)当VDA安装或升级失败时，启用自动返回到恢复点。

  如果安装/升级成功:

  • / enablerestorecleanup指示安装程序删除还原点。
  • /启用还原指示安装程序保留还原点，即使它没有被使用。

  有关详细信息，请参阅安装或升级失败时恢复．

• /排除“成分”[,”成分”]

  防止安装一个或多个逗号分隔的可选组件，每个组件都用直引号括起来。例如，在不由MCS管理的映像上安装或升级VDA不需要机器标识服务组件。有效值为：

  • 机身份服务
  • Citrix概要管理
  • Citrix简介管理WMI插件
  • Citrix通用打印客户端
  • Citrix遥测服务
  • 适用于App-V的Citrix个性化-VDA
  • Citrix可支持性工具
  • Windows的Citrix文件
  • Citrix文件用于Outlook
  • 用户个性化层
  • Citrix的电话代理
  • Citrix MCS IODriver
  • Citrix VDA升级代理

  从安装中排除Citrix配置文件管理(/排除“citrix档案管理”)影响与思杰总监一起监控和排除VDAs的故障。在这一点用户详细信息和终点页面，个性化面板和登录持续时间面板失败。在这一点指示板和趋势页面，平均登录持续时间面板只显示安装了概要文件管理的计算机的数据。

  即使您使用的是第三方用户配置文件管理解决方案，Citrix也建议您安装并运行Citrix配置文件管理服务。不需要启用Citrix配置文件管理服务。

  如果你指定两者/排除和/ includeadditional如果组件名称相同，则未安装该组件。

  使用时，此选项无效VDAWorkstationResetUp.exe安装程序。该安装程序自动排除许多这些项目。

• /小时或/帮助

  显示命令帮助。

• / includeadditional“成分”[,”成分”]

  包括安装一个或多个用逗号分隔的可选组件，每个组件都用引号括起来。当您正在创建远程PC访问部署，并且希望安装默认情况下没有包含的其他组件时，此选项可能会很有帮助。有效值:

  • Citrix概要管理
  • Citrix简介管理WMI插件
  • Citrix通用打印客户端
  • Citrix遥测服务
  • 适用于App-V的Citrix个性化-VDA
  • Citrix可支持性工具
  • Windows的Citrix文件
  • Citrix文件用于Outlook
  • 用户个性化层
  • Citrix的电话代理
  • Citrix MCS IODriver
  • Citrix VDA升级代理

  如果你指定两者/排除和/ includeadditional如果组件名称相同，则未安装该组件。

• / installdir目录

  将安装组件的现有空目录。默认= C：\ Program Files \ Citrix。

• / install_mcsio_driver

  不使用。竖起，使用/include附加的“Citrix MCS IODriver”或/exclude Citrix MCS IODriver"

• / logpath.小路

  日志文件的位置。指定的文件夹必须存在。安装程序不会创建它。默认=“％temp％\ citrix \ xendesktop安装程序”

  此选项在图形界面中不可用。

• / masterimage

  仅当在虚拟机上安装VDA时有效。将VDA设置为用于创建其他机器的映像。这个选项等价于/ mastermcsimage.．

  使用时，此选项无效VDAWorkstationResetUp.exe安装程序。

• / mastermcsimage.

  指定此机器将与机器创建服务一起用作映像。这个选项等价于/ masterimage．

• / masterpvsimage

  指定此机器将作为镜像与Citrix发放或第三方发放工具(如Microsoft System Center Configuration Manager)一起发放虚拟机。

• /无媒体基础确认

  承认没有安装微软媒体基金会，一些HDX多媒体功能将没有安装，并且无法工作。如果省略此选项，且未安装Media Foundation，则VDA安装失败。除了N个版本外，大多数受支持的Windows版本都已经安装了Media Foundation。

• / nodesktopexperience

  增强的桌面体验功能不再可用。如果指定了该选项(和策略设置)，则忽略该选项。

  仅当为多会话操作系统安装VDA时有效。防止启用“增强桌面体验”功能。此功能还可以通过增强的桌面体验Citrix策略设置进行控制。

• / noreboot

  防止安装后重新启动。VDA需要重启后才能使用。

• / noresume

  默认情况下，当安装过程中需要重新启动机器时，安装程序将在重新启动完成后自动恢复。若要覆盖默认值，请指定/ noresume。如果您必须重新安装媒体或希望在自动安装过程中捕获信息，这将非常有用。

• / portnumber港口

  只有在何时有效/重新配置指定了选项。启用VDA和控制器之间通信的端口号。先前配置的端口被禁用，除非是端口80。

• /安静或/被动

  安装过程中没有出现用户界面。安装和配置过程的唯一证据是在Windows任务管理器中。如果省略此选项，则图形界面启动。

• /重新配置

  控件使用时自定义先前配置的VDA设置/ portnumber那/控制器,或/ enable_hdx_ports选项。如果指定此选项而不同时指定/安静选项，用于自定义VDA启动的图形界面。

• / remotepc.

  仅对远程PC接入部署(单会话操作系统)或代理连接(多会话操作系统)有效。不包括在单会话操作系统上安装以下组件:

  • 适用于App-V的Citrix个性化
  • Citrix概要管理
  • Citrix配置文件管理WMI插件
  • 机身份服务
  • Citrix可支持性工具
  • Windows的Citrix文件
  • Citrix文件用于Outlook
  • 用户个性化层
  • Citrix的电话代理
  • Citrix MCS IO写缓存用于存储优化

  使用时，此选项无效VDAWorkstationResetUp.exe安装程序。安装程序自动排除这些组件的安装。

• /除去

  属性指定的组件/组成部分选项

• / remove_appdisk_ack

  授权VDA安装程序卸载已安装的AppDisks VDA插件。

• / remove_pvd_ack

  授权VDA安装程序卸载个人vDisk(如果它已经安装)。

• / removeall

  消除了共识。它不会删除Citrix工作区应用程序(如果已安装)。

• / sendexperiencemetrics

  自动将安装、升级或删除过程中收集的分析信息发送给Citrix。如果省略此选项(或/ disableexperiencemetrics选项），分析在本地收集，但不会自动发送。

• /服务器VDI

  在支持的Windows多会话计算机上为单会话操作系统安装VDA。在Windows多会话机器上为多会话操作系统安装VDA时省略此选项。

  在使用此选项之前，请参见服务器VDI．

  仅在完整产品VDA安装程序中使用此选项。

• / site_guid.guid

  全局唯一标识站点OU (Active Directory organization Unit)。当您使用Active Directory进行发现时，这会将虚拟桌面与站点关联起来(自动更新是推荐的默认发现方法)。站点GUID是在Studio中显示的站点属性。不要同时指定/ site_guid.和/控制器选项。

• / tempdir.目录

  存放安装期间临时文件的目录。默认= c:\Windows\Temp.

  此选项在图形界面中不可用。

• /虚拟机

  仅当在虚拟机上安装VDA时有效。覆盖物理机器的安装程序的检测，其中BIOS信息传递给vm使它们看起来像物理机器。

  此选项在图形界面中不可用。

• / wem_add_firewall_rules

  添加WEM代理防火墙规则。

• / wem_agent_cache_location

  替代WEM代理缓存位置。

• / wem_agent_port.

  WEM代理与WEM基础架构服务器通信的端口。

• / wem_cached_data_sync_port

  WEM代理用于将缓存与WEM基础结构服务器同步的端口。

• / wem_cloud_connectors

  包含WEM部署的资源位置中以逗号分隔的Citrix云连接器列表。

• / wem_server

  WEM基础架构服务器的FQDN或IP地址。

安装VDA的示例

使用全产品安装程序安装VDA:

将单会话操作系统和Citrix Workspace应用安装到虚拟机的默认位置。该VDA作为镜像，使用MCS发放虚拟机。VDA最初将向指定服务器上的Controller注册Contr-Main在域名mydomain．VDA将使用用户个性化层和Windows远程协助。

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers " control - main. mydomain。本地" /enable_hdx_ports /includeadditional "用户个性化层" /mastermcsimage /enable_remote_assistance

使用VDAWorkstationCoreSetup独立安装程序安装单会话操作系统VDA:

以下命令在单会话操作系统上安装Core Services VDA，用于远程PC访问或VDI部署。未安装Citrix Workspace应用程序和其他非核心服务。指定Controller的地址后，Windows Firewall Service中的端口将自动打开。管理员将处理重启。

VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot .exe /quiet /controllers

定制一个共识

安装VDA后，您可以自定义几个设置。从\ x64 \ XenDesktop设置目录，运行XenDesktopVdaSetup.exe，使用下列一个或多个选项，这些选项在用于安装VDA的命令行选项．

• /重新配置(定制VDA时需要)
• /小时或/帮助
• /安静
• / noreboot
• /控制器
• /端口号端口
• / enable_hdx_ports

解决的共识

• 在传送组的Studio显示中VDA版本安装条目的细节窗格可能不是机器上安装的版本。机器的Windows程序和功能显示实际的VDA版本。

• 安装VDA后，只有注册到交付控制器(Delivery Controller)后，才能向用户交付应用程序或桌面。

  要了解VDA注册方法和如何排除注册问题，请参见VDA登记．

用于安装通用打印服务器的命令行选项

下面的选项对XenDesktopPrintServerSetup.exe命令。

• / enable_upsserver_port.

软件	文件夹	文件名称
微软Visual C++ 2017运行时32位和64位	支持> vcredist_2017	vcredist_x64.exe和vcredist_x86.exe.
Citrix诊断设施	x64>虚拟桌面组件	cdf_x64.msi
通用打印服务器服务器组件	x64 >通用打印服务器	UpsServer_x64.msi

如果未指定此选项，安装程序将显示防火墙页面从图形界面。选择自动让安装程序自动添加Windows防火墙规则，或人工让管理员手动配置防火墙。

在打印服务器上安装软件后，使用指南配置通用打印服务器供应打印机．

更多信息

有关Citrix如何报告组件安装结果的信息，请参见Citrix安装返回码．