使用命令行安装

Last published : Nov 13, 2026
重要提示：
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
  • Citrix 会根据其合法利益（包括许可合规性）收集必要的许可基本数据。有关详细信息，请参阅Citrix 许可数据。

简介

本文适用于在安装了 Windows 操作系统的计算机上安装组件。有关适用于 Linux 操作系统的 VDA 的信息，请参阅 Linux Virtual Delivery Agents。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 本文介绍了如何发出产品安装命令。在开始任何安装之前，请查看 准备安装。该文章包含可用安装程序的说明。
要查看命令执行进度和返回值，您必须是原始管理员或使用以管理员身份运行。有关详细信息，请参阅 Microsoft 命令文档。

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

本文介绍了如何发出产品安装命令。在开始任何安装之前，请查看 准备安装。该文章包含可用安装程序的说明。
要查看命令执行进度和返回值，您必须是原始管理员或使用以管理员身份运行。有关详细信息，请参阅 Microsoft 命令文档。
作为直接使用安装命令的补充，产品 ISO 上提供了示例脚本，用于在 Active Directory 中的计算机上安装、升级或删除 VDA。有关详细信息，请参阅 使用脚本安装 VDA。
如果您尝试在不受此 Citrix Virtual Apps and Desktops 版本支持的 Windows 操作系统版本上安装或升级，则会显示一条消息，引导您了解相关选项。请参阅 早期操作系统。
有关 Citrix 如何报告组件安装结果的信息，请参阅Citrix 安装返回代码。

使用完整产品安装程序

要访问完整产品安装程序的命令行界面：
  1. 从 Citrix 下载产品包。访问下载站点需要 Citrix 帐户凭据。
  2. 解压缩文件。或者，刻录 ISO 文件的 DVD。
  3. 使用本地管理员帐户登录到要安装组件的服务器。
  4. 将 DVD 插入驱动器或装载 ISO 文件。 <<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
  5. 从介质上的 \x64\XenDesktop Setup 目录中，运行相应的命令。
    要安装核心组件： 运行 XenDesktopServerSetup.exe，并使用 安装核心组件的命令行选项 中列出的选项。

要安装 VDA： 运行 XenDesktopVDASetup.exe，并使用 中列出的选项。

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

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

**要安装 Workspace Environment Management：** 请遵循 [工作区环境管理](https://docs.citrix.com/cn/zh/workspace-environment-management/current-release/install-and-configure/agent-host.html) 中的指导。

**要安装 Secure Private Access：** 在安装介质的 `x64 > XenDesktop` Setup 文件夹中运行 `XenDesktopSPASetup.exe`。请遵循 Command-line options for installing a Secure Private Access 中的指导。

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

使用 XenDesktopServerSetup.exe 命令安装核心组件时，以下参数选项有效。有关选项的更多详细信息，请参阅 Install core components。
注意：
  • 在使用命令行选项安装核心组件时，请勿使用 /exclude。
  • 如果您使用 /components 升级一个组件，则其他组件也可能会升级。这是为了避免不同组件之间潜在的兼容性问题。
  • 如果您只想升级一个组件，请使用该组件的独立安装程序。请参阅 升级部署。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md

/ceipoptin ceipoptin 等等其他选项.

/components 组件 ...

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 允许 Delivery Controller 安装或升级继续进行，即使硬件检查失败（例如，由于 RAM 不足）。有关详细信息，请参阅 。

允许 Delivery Controller 安装或升级继续，即使硬件检查失败（例如，由于内存不足）。有关详细信息，请参阅硬件检查。
  • /ignore\_site\_test\_failure
    仅在 Controller 升级期间有效。通常，任何站点测试失败都会被忽略，升级会继续进行。如果省略（或设置为 false），任何站点测试失败都会导致安装程序失败，而不会执行升级。默认值 = false
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 在升级期间，如果检测到不受支持的 SQL Server 版本，此选项将被忽略。有关详细信息，请参阅 SQL Server 版本检查。
现有空目录，组件将安装在此处。默认值 = `c:\Program Files\Citrix`。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认值 = `TEMP%\Citrix\XenDesktop Installer`
  • /no_remote_assistance
    仅在安装 Director 时有效。禁用使用 Windows 远程协助的用户影子功能。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
阻止安装后重新启动。（对于大多数核心组件，默认情况下不启用重新启动。）
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
默认情况下，如果在安装期间需要重新启动计算机，安装程序会在重新启动完成后自动恢复。要覆盖默认设置，请指定 `/noresume`。如果您必须重新装载介质或希望在自动化安装期间捕获信息，这会很有帮助。
  • /无SQL

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 阻止在安装 Controller 的服务器上安装 Microsoft SQL Server Express。如果省略此选项，则会安装 SQL Server Express 作为站点数据库。

阻止在您安装 Controller 的服务器上安装 Microsoft SQL Server Express。如果省略此选项，将安装 SQL Server Express 作为站点数据库使用。
此选项不影响用于本地主机缓存的 SQL Server Express LocalDB 的安装。
  • /quiet 或 /passive

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 安装过程中不会出现用户界面。安装过程的唯一证据在 Windows 任务管理器中。如果省略此选项，则会启动图形界面。

安装期间不显示用户界面。安装过程的唯一证据在 Windows 任务管理器中。如果省略此选项，将启动图形界面。
  • /删除
    删除由 /components 选项指定的核心组件。
  • /删除所有
    删除所有已安装的核心组件。
  • /发送体验指标
    自动将安装、升级或删除期间收集的分析数据发送给 Citrix。如果省略此选项（或指定 /disableexperiencemetrics），分析数据将在本地收集，但不会自动发送。
  • /临时目录 目录
    安装期间用于存放临时文件的目录。默认值 = c:\Windows\Temp。
  • /minutestowaitmsimutexfree minutes

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 等待 MSIMutex 释放的分钟数，超时前（默认值为 3 分钟），有效范围是 0 到 60 分钟之间的整数（例如，15、30、45）。

在超时之前等待 MSIMutex 释放的分钟数（默认值为 3 分钟），有效范围是 0 到 60 分钟之间的整数（例如，15、30、45）。

安装核心组件的示例

以下命令在服务器上安装 Delivery Controller™、Studio、Citrix Licensing 和 SQL Server Express。组件通信所需的防火墙端口将自动打开。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,webstudio,licenseserver /configure_firewall
以下命令在服务器上安装 Citrix Virtual Apps™ Controller、Studio 和 SQL Server Express。组件通信所需的防火墙端口将自动打开。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /xenapp /components controller,webstudio /configure_firewall
以下命令在服务器上安装 Delivery Controller、Secure Private Access 和 SQL Server Express。组件通信所需的防火墙端口将自动打开。
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 如果您从 Citrix Virtual Apps and Desktops 2407 版升级到 2411 或更高版本，或者执行 2411 或更高版本的新安装，请首先将许可证服务器更新到最新版本（版本 11.2.17 build 51000）。然后，升级 Delivery Controller。否则将导致命令行安装和升级失败。运行以下命令以升级许可证服务器和 Delivery Controller、Studio 和 Citrix Director 等组件（假设您位于已装载 ISO 中的 \x64 文件夹内）。

如果您从 Citrix Virtual Apps and Desktops 2407 版升级到 2411 版或更高版本，或者执行 2411 版或更高版本的新安装，请首先将许可证服务器更新到最新版本（版本 11.2.17 build 51000）。然后，升级 Delivery Controller。否则将导致命令行安装和升级失败。运行以下命令以升级许可证服务器和 Delivery Controller、Studio 和 Citrix Director 等组件（假设您位于已装载 ISO 中的 \x64 文件夹内）。
  1. 运行以下命令：
    \x64\Licensing\CitrixLicensing.exe /quiet
    如果您已将许可二进制文件复制到任何本地驱动器，请运行以下命令：
    \x64\Licensing\CitrixLicensing.exe /quiet /l install.log
  2. 运行以下命令：
    \x64\XenDesktop Setup\XenDesktopServerSetup.exe /components "CONTROLLER,WEBSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL

使用独立 VDA 安装程序

访问下载站点需要 Citrix 帐户凭据。您必须在开始安装之前拥有提升的管理权限，或者使用以管理员身份运行。
  1. 从 Citrix 下载相应的软件包：
    • 多会话操作系统虚拟投递代理：VDAServerSetup_xxxx.exe <<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
    • 单会话操作系统虚拟投递代理：VDAWorkstationSetup_xxxx.exe
    • 单会话操作系统核心服务虚拟投递代理：VDAWorkstationCoreSetup_xxxx.exe
    • 新的单会话操作系统核心服务虚拟投递代理：VDASingleSessionCoreSetup_xxxx.exe

可以先将文件从软件包中提取到现有目录，然后运行安装命令，或者直接运行软件包。

  • 单会话操作系统虚拟投递代理: VDAWorkstationSetup_xxxx.exe
  • 单会话操作系统核心服务虚拟投递代理: VDAWorkstationCoreSetup_xxxx.exe
  • 新建单会话操作系统核心服务虚拟投递代理: VDASingleSessionCoreSetup_xxxx.exe

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 要运行下载的软件包，请运行其名称：VDAServerSetup.exe、VDAWorkstationSetup.exe、VDAWorkstationCoreSetup.exe或 VDASingleSessionCoreSetup。使用本文中列出的有效选项。

要运行下载的程序包，请运行其名称：`VDAServerSetup.exe`、`VDAWorkstationSetup.exe`、`VDAWorkstationCoreSetup.exe`或 `VDASingleSessionCoreSetup`。使用本文中列出的有效选项。
如果您熟悉完整产品安装程序：
  • 运行独立的 VDAServerSetup.exe 或 VDAWorkstationSetup.exe 安装程序，就像它是 XenDesktopVdaSetup.exe 命令一样，只是名称不同。
  • VDAWorkstationCoreSetup.exe 或 VDASingleSessionCoreSetup.exe 安装程序有所不同，因为它支持其他安装程序可用选项的子集。

用于安装 VDA 的命令行选项

以下选项适用于以下一个或多个命令（安装程序）：VDAServerSetup_xxxx.exe、VDAWorkstationSetup_xxxx.exe、VDAWorkstationCoreSetup_xxxx.exe 和 VDASingleSessionCoreSetup_xxxx.exe。

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 有关选项的更多详细信息，请参阅。

有关选项的更多详细信息，请参阅 安装 VDA。
  • /components 组件\[,组件\]
    逗号分隔的用于安装或删除的组件列表。有效值为：
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
  • VDA：虚拟投递代理
  • PLUGINS: 适用于 Windows 的 Citrix Workspace 应用程序
  • CSA: 思杰安全访问客户端
  • UPL: Citrix 用户个性化层（仅适用于 WS VDA）
  • SRAGENT: 会话录制代理
  • ASSISTANTAPP：Citrix 虚拟桌面助手
  • CEAL: Citrix 弹性应用分层（仅适用于 TS VDA） =====================================
    • VDA: 虚拟投递代理
    • PLUGINS：适用于 Windows 的 Citrix Workspace 应用程序
    • CSA: Citrix 安全接入客户端
    • UPL：Citrix 用户个性化层（仅适用于 WS VDA）
    • SRAGENT：会话录制代理
    • ASSISTANTAPP: Citrix 虚拟桌面助手
    • CEAL: Citrix 弹性应用分层 (仅适用于 TS VDA)
从 2507 LTSR 开始，Citrix Device Trust、Citrix uberAgent 和 Citrix Workspace Environment Management™ (WEM) Agent 已集成到默认 VDA 安装中。这些组件作为 VDA 设置的一部分静默安装，不再作为单独的组件进行管理。
注意：
如果在环境中检测到现有独立版本的 Citrix uberAgent®，安装程序将不会安装、升级或卸载它。
常见组件选择示例：
  • 要使用 WS VDA 安装程序安装所有受支持的组件，请指定 /components VDA,PLUGINS,CSA,UPL,SRAGENT,ASSISTANTAPP。这等同于在 WS VDA 安装程序的“组件”页面上选择所有可用组件。
  • 要使用 TS VDA 安装程序安装所有受支持的组件，请指定 /components VDA,PLUGINS,CSA,CEAL,SRAGENT,ASSISTANTAPP。这等同于在 TS VDA 安装程序的“组件”页面上选择所有可用组件。
  • 如果省略 /components，安装程序默认安装 VDA、SRAGENT 和 ASSISTANTAPP。在安装程序用户界面中，这等同于选择 Virtual Delivery Agent、Session Recording Agent 和 Citrix Virtual Desktop Assistant。
  • 要安装 VDA 和适用于 Windows 的 Citrix Workspace 应用程序，请指定 /components VDA,PLUGINS。
  • 要仅安装 VDA，请指定 /components VDA。这不包括适用于 Windows 的 Citrix Workspace 应用程序和其他组件。
此选项不适用于 VDAWorkstationCoreSetup_xxxx.exe 和 VDASingleSessionCoreSetup_xxxx.exe 安装程序。这些安装程序不支持适用于 Windows 的 Citrix Workspace 应用程序或其他可选组件。
  • 仅限先决条件
    将仅安装所选组件的必备项。不会安装任何 Citrix 产品组件。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
  • /controllers "控制器 \[控制器\]"
  • 禁用体验指标
    阻止自动上传在安装、升级或删除期间收集到 Citrix 的分析数据。
  • /enable\_hdx\_ports

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 如果检测到 Windows 防火墙服务，即使防火墙未启用，也会打开 VDA 和已启用功能（Windows 远程协助除外）所需的 Windows 防火墙中的端口。如果您使用的是其他防火墙或没有防火墙，则必须手动配置防火墙。有关端口信息，请参阅。

如果检测到 Windows 防火墙服务，即使未启用防火墙，也会打开 VDA 和已启用功能（Windows 远程协助除外）所需的 Windows 防火墙中的端口。如果您使用的是其他防火墙或没有防火墙，则必须手动配置防火墙。有关端口信息，请参阅[网络端口](https://docs.citrix.com/cn/zh/tech-zone/build/tech-papers/citrix-communication-ports.html#citrix-virtual-apps-and-desktops)。
要打开 HDX 自适应传输使用的 UDP 端口，除了此 `/enable_hdx_ports` 选项外，还要指定 `/enable_hdx_udp_ports` 选项。
  • /enable\_hdx\_udp\_ports
    如果检测到 Windows 防火墙服务，则在 Windows 防火墙中打开 HDX 自适应传输使用的 UDP 端口，即使防火墙未启用也是如此。如果您使用的是其他防火墙或没有防火墙，则必须手动配置防火墙。有关端口信息，请参阅 网络端口。
    要打开 VDA 使用的额外端口，除了此 /enable_hdx_udp_ports 选项之外，还要指定 /enable_hdx_ports 选项。
  • /enable_hdx_tls_dtls
    为 HDX™ Direct V1 打开 TCP 和 UDP 端口 443。
  • /enable\_real\_time\_transport
    启用或禁用将 UDP 用于音频数据包（用于音频的实时音频传输）。启用此功能可以提高音频性能。如果希望在检测到 Windows 防火墙服务时自动打开 UDP 端口，请包含 /enable_hdx_ports 选项。
  • /enable_remote_assistance
    启用 Windows 远程协助中的影子功能，以便与 Director 结合使用。如果指定此选项，Windows 远程协助将在防火墙中打开动态端口。
  • /enablerestore 或 /enablerestorecleanup
    （仅适用于单会话 VDA）如果 VDA 安装或升级失败，则启用自动返回到还原点。
    如果安装/升级成功完成：
    • /enablerestorecleanup 指示安装程序删除还原点。 <<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
有关详细信息，请参阅[安装或升级失败时恢复](../install-prepare.md#安装或升级失败时恢复)。
  • /ENABLE_SECURE_DEFAULTS
    将各种功能的默认设置从启用更改为禁用，以实现更安全的开箱即用配置。相关功能包括：客户端驱动器重定向、特殊文件夹重定向、拖放、客户端 TWAIN 设备重定向、客户端 USB 即插即用设备重定向、客户端打印机重定向、客户端剪贴板重定向和客户端麦克风重定向。
  • /enable\_ss\_ports
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 如果在检测到 Windows 防火墙服务时，即使防火墙未启用，也会打开 Windows 防火墙中屏幕共享所需的端口。如果您使用不同的防火墙或不使用防火墙，则必须手动配置防火墙。
  • /SKIPHDXDRIVERCHECK
    跳过将 HDX™ 驱动程序检查到 VDA 元安装程序。
阻止安装一个或多个以逗号分隔的可选组件，每个组件都用直引号括起来。例如，在不受 MCS 管理的映像上安装或升级 VDA 不需要 Machine Identity Service 组件。有效值如下：

| 多会话操作系统 | 单会话操作系统 | 单会话操作系统核心服务 | 新单会话操作系统核心服务 |
| --- | --- | --- | --- |
| `Citrix Authentication Identity Assertion VDA Plug-in` | `Citrix Authentication Identity Assertion VDA Plug-in` | `Citrix Authentication Identity Assertion VDA Plug-in` | `Citrix Authentication Identity Assertion VDA Plug-in` |
| `Citrix Backup and Restore` | `Citrix Backup and Restore` | | |
| `Citrix deviceTRUST®` | `Citrix deviceTRUST` | `Citrix deviceTRUST` | `Citrix deviceTRUST` |
| `Citrix Secure Access Client` | `Citrix Secure Access Client` | | |
| `Citrix Workspace Environment Management™ Agent` | `Citrix Workspace Environment Management Agent` |  | `Citrix Workspace Environment Management Agent` |
| `Citrix Browser Content Redirection` | `Citrix Browser Content Redirection` | `Citrix Browser Content Redirection` | `Citrix Browser Content Redirection` |
| `Citrix MCS IODriver` | `Citrix MCS IODriver` | | |
| `Citrix Personalization for App-V - VDA` | `Citrix Personalization for App-V - VDA` | | |
| `Citrix Profile Management` | `Citrix Profile Management` | | `Citrix Profile Management` |
| `Citrix Profile Management WMI Plug-in` | `Citrix Profile Management WMI Plug-in` |  | `Citrix Profile Management WMI Plug-in` |
| `Citrix Rendezvous V2` | `Citrix Rendezvous V2` | `Citrix Rendezvous V2` | `Citrix Rendezvous V2`|
| `Citrix Telemetry Service` | `Citrix Telemetry Service` | `Citrix Telemetry Service` | `Citrix Telemetry Service` |
| `Citrix Universal Print Client` | `Citrix Universal Print Client` | `Citrix Universal™ Print Client` | `Citrix Universal Print Client` |
| `Citrix VDA Upgrade Agent` | `Citrix VDA Upgrade Agent` |  | `Citrix VDA Upgrade Agent` |
| `CSE Component` | `CSE Component` | `CSE Component` | `CSE Component` |
| `Director VDA Plug-in` | `Director VDA Plug-in` | `Director VDA Plug-in` | `Director VDA Plug-in` |
| `Machine Identity Service` | `Machine Identity Service` |  | |
| `Machine Management Provider` | `Machine Management Provider` | `Machine Management Provider` | `Machine Management Provider` |
| `Elastic App Layering` | `User Personalization Layer` |  |  |
| `VDA Monitor Plug-in` | `VDA Monitor Plug-in` | `VDA Monitor Plug-in` | `VDA Monitor Plug-in` |
| `VDA WMI Proxy Plug-in` | `VDA WMI Proxy Plug-in` | `VDA WMI Proxy Plug-in` | `VDA WMI Proxy Plug-in` |
| `Citrix App Protection Component` | `Citrix App Protection Component` | `Citrix App Protection Component` | `Citrix App Protection Component` |
| `Citrix HyperV Filter Driver` | `Citrix HyperV Filter Driver` | `Citrix Web Socket Vda Registration Tool` | `Citrix Web Socket Vda Registration Tool` |
| `App Packages Delivery Component` | `App Packages Delivery Component` | `App Packages Delivery Component` | `App Packages Delivery Component` |
| `Session Recording Agent​` | `Session Recording Agent​` | | |
| `Citrix Virtual Desktop Assistant` | `Citrix Virtual Desktop Assistant` | | |

从安装中排除 Citrix Profile Management (`/exclude "Citrix Profile Management"`) 会影响使用 Citrix Director 对 VDA 进行监视和故障排除。在**用户详细信息**和**端点**页面上，个性化面板和登录持续时间面板将失败。在**控制板**和**趋势**页面上，平均登录持续时间面板仅显示已安装 Profile Management 的计算机的数据。

即使您正在使用第三方用户配置文件管理解决方案，Citrix 仍建议您安装并运行 Citrix Profile Management Service。无需启用 Citrix Profile Management Service。

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md Citrix App-V 个性化 – VDA 已更名为应用程序包交付组件，Citrix 助手应用程序已更名为 Citrix 虚拟桌面助手。

思杰 App-V 个性化 – VDA 已重命名为 应用程序包交付组件，思杰助手应用 已重命名为 思杰虚拟桌面助手。
可以使用 `/components` 安装的组件也可以通过省略该组件来排除。例如，要排除 Citrix Secure Access Client、Session Recording Agent 和 Citrix Virtual Desktop Assistant，请指定 `/components VDA`。如果您未指定 `/components`，请使用 `/exclude` 排除这些组件。

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 如果同时指定 /exclude 和 /includeadditional 并使用相同的组件名称，则不会安装该组件。

如果同时指定 `/exclude` 和 `/includeadditional` 并使用相同的组件名称，则不安装该组件。
  • /h 或 /help
    显示命令帮助。
  • /includeadditional "组件"\[,"组件"\]

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 包括安装一个或多个以逗号分隔的可选组件，每个组件都用直引号括起来。当您创建远程 PC 访问部署并希望安装默认不包含的其他组件时，此选项会很有帮助。有效值如下所示：

包括安装一个或多个以逗号分隔的可选组件，每个组件都用直引号引起来。当您创建远程电脑访问部署并希望安装默认情况下不包含的其他组件时，此选项会很有用。有效值如下：
| 多会话操作系统 | 单会话操作系统 |
| --- | --- |
| `Citrix Backup and Restore` | `Citrix Backup and Restore` |
| `Citrix MCS IODriver` | `Citrix MCS IODriver` |
| `App Packages Delivery Component` | `App Packages Delivery Component` |
| `Citrix Profile Management` | `Citrix Profile Management` |
| `Citrix Profile Management WMI Plug-in` | `Citrix Profile Management WMI Plug-in` |
| `Citrix Rendezvous V2` | `Citrix Rendezvous V2` |
| `Citrix VDA Upgrade Agent` | `Citrix VDA Upgrade Agent` |
| `Citrix Web Socket Vda Registration Tool` | `Citrix Web Socket Vda Registration Tool` |
| `VDA Token Enrollment` | `VDA Token Enrollment` |

如果同时指定 `/exclude` 和 `/includeadditional` 并使用相同的组件名称，则不会安装该组件。
  • /installdir 目录

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 将安装组件的现有空目录。默认值 = c:\Program Files\Citrix。

将安装组件的现有空目录。默认值 = c:\\Program Files\\Citrix。
  • /install_mcsio_driver
    请勿使用。请改用 /includeadditional "Citrix MCS IODriver" 或 /exclude "Citrix MCS IODriver"。
  • /logpath 路径

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 日志文件位置。指定的文件夹必须存在。安装程序不会创建它。默认值 = "%TEMP%\Citrix\XenDesktop Installer"

日志文件位置。指定的文件夹必须存在。安装程序不会创建该文件夹。默认值 = "%TEMP%\\Citrix\\XenDesktop Installer"
此选项在图形界面中不可用。
  • /主映像
    仅在虚拟机上安装 VDA 时有效。将 VDA 设置为用于创建其他计算机的映像。此选项等效于 /mastermcsimage。
    此选项在使用 VDAWorkstationCoreSetup_xxxx.exe 安装程序时无效。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
指定此计算机将用作 Machine Creation Services 的映像。此选项等同于 `/masterimage`。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
  • /PVS主映像
    指定此计算机将用作映像，与 Citrix Provisioning™ 或第三方预配工具（例如 Microsoft System Center Configuration Manager）一起用于预配 VM。
  • /websockettoken WebSocket 令牌
    创建 Web Socket VDA。WebSocketToken 用于所需的令牌。
创建 Web Socket VDA。*FileContainingWebSockToken* 指的是包含所需令牌的文件。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
创建 Web Socket VDA。*<WebSocketToken* 指的是通过 STDIN 传入的所需令牌。
  • /no\_mediafoundation\_ack
    确认未安装 Microsoft Media Foundation，并且多个 HDX 多媒体功能将不会安装且无法工作。如果省略此选项且未安装 Media Foundation，则 VDA 安装将退出，因为未满足先决条件。大多数受支持的 Windows 版本都已安装 Media Foundation，N 版本除外。如果手动启用“Windows 功能”>“媒体功能”，则 Citrix Meta Installer 查找的注册表项可能没有设置值。在开始安装过程之前，请检查 SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersion 注册表项以确认该值存在且不为空。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
  • /nodesktopexperience（不安装桌面体验）
    增强桌面体验功能不再可用。如果指定此选项（和策略设置），则会将其忽略。
    仅在安装适用于多会话操作系统的 VDA 时有效。阻止启用增强桌面体验功能。此功能也通过增强桌面体验 Citrix 策略设置进行控制。
阻止安装后重新启动。VDA 必须在重新启动后才能使用。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
默认情况下，如果在安装过程中需要重新启动计算机，安装程序会在重新启动完成后自动恢复。要覆盖默认设置，请指定 `/noresume`。如果您必须重新装载介质或希望在自动化安装期间捕获信息，这会很有帮助。
  • /物理机
    将此参数与 /remotepc 一起用于 RemotePC 安装。否则，VDA 在某些用户场景中可能无法按预期运行。
  • /端口号 端口
    仅当指定了 /reconfig 选项时有效。用于启用 VDA 与 Controller 之间通信的端口号。除非是端口 80，否则以前配置的端口将被禁用。
  • /代理配置 “地址或PAC文件路径”
    如果您计划在您的环境中使用 Rendezvous V2 协议以及 Gateway Service 等服务，并且您的网络中存在用于出站连接的非透明代理，请在此处指定代理。仅支持 HTTP 代理。用于 Rendezvous 协议的代理地址或 PAC 文件路径。此命令行会自动安装 Citrix Rendezvous V2，如同使用了 /includeadditional "Citrix Rendezvous V2"。有关功能详细信息，请参阅 Rendezvous 协议。
    • 代理地址格式：http://<url-or-ip>:<port>
    • PAC 文件格式：http://<url-or-ip>:<port>/<path>/<filename>.pac
  • /quiet 或 /passive
    安装过程中不会出现用户界面。安装和配置过程的唯一证据在 Windows 任务管理器中。如果省略此选项，则会启动图形界面。
  • /重新配置
    与 /portnumber、/controllers 或 /enable_hdx_ports 选项一起使用时，自定义先前配置的 VDA 设置。如果指定此选项但未同时指定 /quiet 选项，则会启动用于自定义 VDA 的图形界面。
  • 远程电脑

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 仅适用于远程电脑访问部署（单会话操作系统）或代理连接（多会话操作系统）。排除安装任何附加组件（请参阅 /exclude 和 /includeadditional 选项的组件列表）。

仅适用于远程电脑访问部署（单会话操作系统）或代理连接（多会话操作系统）。排除安装任何其他组件（请参阅 `/exclude` 和 `/includeadditional` 选项中的组件列表）。
使用 `VDAWorkstationCoreSetup.exe` 安装程序时，此选项无效。该安装程序会自动排除这些组件的安装。

`/remotepc` 与 `/servervdi` 选项不兼容。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
删除使用 `/components` 选项指定的组件。
  • /remove_appdisk_ack
    授权 VDA 安装程序卸载 AppDisks™ VDA 插件（如果已安装）。
  • /remove_pvd_ack
    授权 VDA 安装程序卸载 Personal vDisk（如果已安装）。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
删除 VDA。它不会删除 Citrix Workspace 应用程序（如果已安装）。
  • /REMOVEALLWITHCWA

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 删除 CWA 和 VDA。

随 VDA 一起删除 CWA。
  • /发送体验指标
    在安装、升级或删除过程中自动将收集到的分析数据发送给 Citrix。如果省略此选项（或指定了 /disableexperiencemetrics 选项），则分析数据将在本地收集，但不会自动发送。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
在受支持的 Windows 多会话计算机上安装适用于单会话操作系统的 VDA。在 Windows 多会话计算机上安装适用于多会话操作系统的 VDA 时，请省略此选项。

使用此选项之前，请参阅 [Server VDI](../server-vdi.md)。

仅将此选项与完整产品 VDA 安装程序结合使用。
<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md
  • /站点GUID GUID
    站点的 Active Directory 组织单位 (OU) 的全局唯一标识符。当您使用 Active Directory 进行发现时（自动更新是推荐的默认发现方法），这会将虚拟桌面与站点关联。站点 GUID 是 Studio 中显示的站点属性。请勿同时指定 /site_guid 和 /controllers 选项。
  • /临时目录 目录
此选项在图形界面中不可用。
  • /虚拟机
    仅在 VM 上安装 VDA 时有效。覆盖安装程序对物理机的检测，因为传递给 VM 的 BIOS 信息使其显示为物理机。
    此选项在图形界面中不可用。
  • /minutestowaitmsimutexfree 分钟
    等待 MSIMutex 释放的分钟数，超时前（默认值为 3 分钟），有效范围是 0 到 60 分钟之间的整数（例如，15、30、45）。

安装 VDA 的示例

使用完整产品安装程序安装 VDA：
以下命令将为单会话操作系统和 Citrix Workspace 应用程序安装 VDA 到 VM 上的默认位置。此 VDA 将用作映像，并使用 MCS 预配 VM。VDA 将首先在域 mydomain 中名为 Contr-Main 的服务器上向 Controller 注册。VDA 将使用用户个性化层和 Windows 远程协助。
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance
使用 VDAWorkstationCoreSetup 独立安装程序安装单会话操作系统 VDA：

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 以下命令在单会话操作系统上安装核心服务 VDA，用于远程 PC 访问或 VDI 部署。Citrix Workspace 应用程序和其他非核心服务未安装。指定了 Controller 的地址，Windows 防火墙服务中的端口将自动打开。管理员将处理重新启动。

以下命令在单会话操作系统上安装核心服务 VDA，用于远程 PC 访问或 VDI 部署。Citrix Workspace 应用程序和其他非核心服务未安装。指定了 Controller 的地址，并且 Windows 防火墙服务中的端口将自动打开。管理员将处理重新启动。
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

自定义 VDA

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 安装 VDA 后，您可以自定义多项设置。从产品介质上的 \x64\XenDesktop Setup 目录中，运行 XenDesktopVdaSetup.exe，使用以下一个或多个选项，这些选项在 中进行了描述。

安装 VDA 后，您可以自定义多项设置。从产品介质上的 \x64\XenDesktop Setup 目录中，运行 XenDesktopVdaSetup.exe，使用以下一个或多个选项，这些选项在安装 VDA 的命令行选项 中进行了描述。
  • /reconfigure（自定义 VDA 时必需）
  • /h 或 /help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber port
  • /enable_hdx_ports

VDA 故障排除

  • 在交付组的 Studio 显示中，详细信息窗格中的已安装的 VDA 版本条目可能不是计算机上安装的版本。计算机的 Windows 程序和功能显示会显示实际的 VDA 版本。
  • VDA 安装后，必须先向 Delivery Controller 注册，然后才能向用户交付应用程序或桌面。

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 要了解 VDA 注册方法以及如何排查注册问题，请参阅 。

要了解 VDA 注册方法以及如何排查注册问题，请参阅VDA 注册。

安装 Universal Print Server 的命令行选项

以下选项对 XenDesktopPrintServerSetup.exe 命令有效。
  • /enable_upsserver_port
如果未指定此选项，安装程序将从图形界面显示防火墙页面。选择自动以让安装程序自动添加 Windows 防火墙规则，或选择手动以让管理员手动配置防火墙。

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 在打印服务器上安装软件后，请按照 中的指导配置 Universal Print Server。

在打印服务器上安装软件后，请按照 Citrix 通用打印服务器 (UPS) 中的指导配置通用打印服务器。

安装 Secure Private Access 的命令行选项

以下选项对两者均有效：
  1. CVAD 安装程序：XenDesktopSPASetup.exe <<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md

SPA 本地安装程序：SecurePrivateAccessSetup_XXXX.exe

/noreboot（禁止重新启动）

/quiet 或 /passive

<<<<<<<< HEAD:zh-cn/citrix-virtual-apps-desktops/current-release/install-configure/install-core/install-command.md 删除安全专用访问。

删除安全私有访问。
有关这些选项的更多详细信息，请参阅Secure Private Access 安装程序。

更多信息

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