安装代理
本文首先介绍 Workspace Environment Management (WEM) 代理。本文的其余部分介绍了代理安装向导中的步骤。还提供了与代理商有关的其他信息。
简介
WEM 管理的每台计算机上都必须安装 WEM 代理。WEM 代理连接到 WEM 服务并强制执行您在管理控制台中配置的设置。所有通信都通过使用 Citrix Cloud Messaging Service 通过 HTTPS 进行。所有代理都使用本地缓存，确保在网络连接中断时它们可以继续使用现有设置。
WEM 支持管理已加入域的计算机和未加入域的计算机。
-
对于已加入域的计算机，请确保代理主机与配置的云连接器属于同一 Active Directory 域。此外，请确保每个资源位置中的代理主机都已正确加入。
-
在未加入域的计算机上安装代理的过程与加入域的计算机的过程类似。但是，请确保满足所有要求，并在整个过程中选择正确的选项。有关详细信息，请参阅 管理未加入域的计算机。
有三种方法可以将代理连接到 WEM 服务：
- Cloud Connector
- 未加入域
- 注册
有关这些方法的更多信息，请参阅 确定要使用的安装方法。
安装代理
注意：
要从管理控制台访问作为应用程序快捷方式在 Citrix Workspace 中发布的资源，请确保代理计算机上安装了适用于 Windows 的 Citrix Workspace 应用程序。有关详细信息，请参阅系统要求。
使用以下顺序安装 WEM 代理。
步骤 1：下载代理
从 WEM 服务 实用程序选项卡下载 WEM 代理程序包 (Citrix-Workspace-Environment-Management-Agent-Setup.zip )，然后在每台代理主机上保存一份副本。
步骤 2：配置组策略（可选）
重要：
如果您选择使用未加入域名或注册方法，请跳过此步骤。
或者，您可以选择配置组策略。WEM Agent 软件包中提供的代理组策略管理模板添加了代理主机配置策略。
-
将 WEM 安装包提供的代理组策略文件夹复制到您的 WEM 域控制器。
-
添加 .admx 文件。
- 转到 代理组策略 > ADMX 文件夹。
- 复制这两个文件（Citrix Workspace Environment Management Agent Host Configuration.admxx 和 CitrixBase.admx）。
- 转到
<C:\Windows>\PolicyDefinitions文件夹，然后粘贴文件。
-
添加 .adml 文件。
- 转到 代理组策略 > ADMX > en-US 文件夹。
- 复制这两个文件（Citrix Workspace Environment Management Agent Host Configuration.adml 和 CitrixBase.adml）。
- 转到
<C:\Windows>\PolicyDefinitions\en-US文件夹，然后粘贴文件。
-
在组策略管理编辑器窗口中，转到 计算机配置 > 策略 > 管理模板 > Citrix 组件 > Workspace Environment Management > 代理主机配置 ，然后配置以下设置：
基本部署的自定义设置。用于部署的自定义代理设置。有关基本部署的可用代理设置的更多信息，请参阅管理基本部署代理。
覆盖代理部署类型。覆盖 WEM 代理部署类型。您可以选择云服务、本地部署或基本部署。
代理代理配置。WEM 代理依赖互联网连接来连接到 Citrix Cloud 中的 WEM 服务。代理与服务之间的通信有以下目的：
- 将统计信息和状态上载到 WEM 服务
- 使代理缓存与 WEM 服务数据库保持同步
- 检索代理设置和特定于代理配置集的 WEM 设置
或者，您可以选择配置 HTTPS 代理以定义代理与服务通信的方式。为此，请双击 代理代理配置 策略，然后按以下格式键入代理服务器地址： http://<FQDN or IP address>:<port number>。示例：http://10.108.125.51:8080。
注意：
WEM 服务不支持要求身份验证的代理服务器。
代理服务端口。WEM 服务不需要。保持状态“未配置”。
缓存的数据同步端口。WEM 服务不需要。保持状态“未配置”。
Citrix Cloud Connector。至少配置一个 Citrix Cloud Connector。代理主机必须与配置的 Cloud Connector 计算机位于同一 AD 域中。
通过CVAD 服务发现 Citrix Cloud Connector。如果您尚未为代理配置 Cloud Connector，则允许您控制代理是否从相关 Citrix DaaS（以前称为 Citrix Virtual Apps and Desktops 服务）部署中发现 Cloud Connector 信息。然后代理连接到相应的 Cloud Connector 计算机。
注意：
- 此设置适用于在 Citrix DaaS 部署中运行 WEM 代理的场景。
- 如果在代理安装期间配置了云连接器或启用了 Citrix Cloud Connector 策略设置，则此策略设置将不起作用。
基础设施服务器。WEM 服务不需要。保持状态“未配置”。
VUEMAppCmd 额外的同步延迟。指定代理应用程序启动器 (VUEMAppCmd.exe) 在启动已发布资源之前等待的时间（以毫秒为单位）。这可确保首先完成必要的代理工作。建议的值为 100 到 200。默认值为 0。
步骤 3：安装代理
重要：
虽然 .NET Framework 可以在代理安装期间自动安装，但我们建议您在安装代理之前手动安装它。否则，您需要重新启动计算机才能继续代理安装，并且可能需要很长时间才能完成。
代理下载中提供了客户端安装程序 Citrix Workspace Environment Management Agent。您可以选择以交互方式安装代理，也可以使用命令行安装代理。默认情况下，代理安装到以下文件夹之一，具体取决于您的操作系统 (OS)：
- C:\Program Files (x86)\Citrix\Workspace Environment Management Agent（在 64 位操作系统中）
- C:\Program Files\ Citrix\Workspace Environment Management Agent（在 32 位操作系统中）
要以交互方式安装代理，请完成以下步骤：
- 在计算机上运行 Citrix Workspace Environment Management Agent.exe。
- 选择“我同意许可条款和条件”，然后单击安装。
-
在“欢迎”页面上，单击“下一步”。
注意：
“欢迎”页面可能需要一些时间才能显示。当所需软件丢失并且正在后台安装时，会发生这种情况。
-
在“目标文件夹”页面上，单击“下一步”。
- 默认情况下，目标文件夹字段会自动填充默认文件夹路径。如果要将代理安装到另一个文件夹，请单击更改以导航到该文件夹，然后单击下一步。
- 如果已安装 WEM 代理，则目标文件夹字段将自动填充现有安装文件夹路径。
-
在“部署类型”页面上，选择适用的部署类型，然后单击“下一步”。在这种情况下，请选择 云服务部署。
-
您也可以选择基本部署类型。当您选择基本部署类型时，代理会在不连接到基础设施服务的情况下开启默认优化设置。
-
在云服务配置页面上，指定代理连接到的 Citrix Cloud 连接器，然后单击 下一步。
-
跳过配置。如果出现以下情况，请选择此选项：
- 您已经使用组策略配置了此设置。
- 代理计算机是未加入域的计算机。请参阅 管理未加入域的计算机。
- 您希望在不配置云连接器的情况下注册代理。请参阅 注册代理。
-
配置 Citrix Cloud 连接器。通过键入以逗号分隔的云连接器的 FQDN 或 IP 地址列表来配置代理所连接的 Citrix Cloud 连接器。
注意：
- 键入每个 Citrix Cloud Connector 的 FQDN 或 IP 地址。确保用逗号 (,) 分隔 FQDN 或 IP 地址。- 在配置了多个 Cloud Connector 的情况下，WEM 代理会从列表中随机选择一个可访问的云连接器。此设计旨在将流量分配到所有云连接器。
-
-
在“高级设置”页面上，为代理配置高级设置，然后单击“下一步”。
-
备用缓存位置（可选）。用于指定代理缓存的替代位置。单击 浏览 以导航到适用的文件夹。或者，您可以通过注册表执行此操作。为此，请先停止 Citrix WEM Agent Host Service，然后修改以下注册表项。
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host
名称：AgentCacheAlternateLocation
类型：REG_SZ
值：空
默认情况下，该值为空。默认文件夹为：
<WEM agent installation folder path>\Local Databases Set。如有必要，请指定其他文件夹路径。要使更改生效，请重新启动 Citrix WEM Agent Host Service。如果更改生效，文件夹中将显示以下文件： LocalAgentCache.db 和 LocalAgentDatabase.db。小心：
注册表编辑不当会导致严重问题，可能需要重新安装操作系统。Citrix 无法保证因注册表编辑器使用不当导致出现的问题能够得以解决。使用注册表编辑器需自担风险。在编辑注册表之前，请务必进行备份。
-
VUEMAppCmd 额外同步延迟（可选）。允许您指定代理应用程序启动器 (VUEMAppCmd.exe) 在发布的资源启动之前等待多长时间。这可确保首先完成必要的代理工作。默认值为 0。
注意：
为额外的同步延迟间隔键入的值必须是大于或等于零的整数。
-
- 在“准备安装”页面上，单击“安装”。
- 单击“完成”退出安装向导。
或者，也可以使用命令行选择 WEM 代理的静默安装。若要执行此操作，请使用以下命令行：
Citrix Workspace Environment Management Agent.exe /quiet Cloud=1
提示：
- 对于在 WEM 服务部署中运行的代理，请输入
Cloud=1。对于在本地 WEM 部署中运行的代理，请输入Cloud=0。- 您可能需要查看日志文件以解决代理安装问题。默认情况下，记录安装过程中发生的所有操作的日志文件是在 %TEMP% 中创建的。您可以使用
/log log.txt命令为要保存的日志文件指定特定位置。
您还可以使用命令行选项来指定自定义参数。这样可以在安装过程中自定义代理和系统设置。有关详细信息，请参阅须知。
安装后，代理作为以下服务运行： Citrix WEM Agent Host Service 和 Citrix WEM Agent User Logon Service。代理作为帐户 LocalSystem运行。不支持更改此帐户。代理服务需要“以本地系统身份登录”权限。
步骤 4：重新启动计算机以完成安装
卸载代理
- 在安装了代理的计算机上，打开系统的控制面板。
- 单击“程序和功能”。
- 选择 Citrix Workspace Environment Management Agent，然后在菜单中单击卸载。
如果在安装 VDA 时将代理作为附加组件安装，请使用 VDA 安装程序提供的 WEM 安装程序 (MSI) 卸载代理。WEM 安装程序 citrix_wem_agent_core.msi 位于 <VDA installer path>\x64\Virtual Desktop Components 中。要卸载作为 VDA 附加组件安装的代理，请完成以下步骤：
- 在文件夹中，右键单击
citrix_wem_agent_core.msi。 - 选择卸载。
注意：
卸载代理后，可以使用 VDA 安装程序或 WEM 安装程序进行安装。自 Citrix Virtual Apps and Desktops 2209 起，WEM 代理不再作为附加组件包含在 VDA 安装中。要进行安装，请使用 Citrix Virtual Apps and Desktops 产品 ISO 上的完整产品安装程序。有关详细信息，请参阅安装核心组件。
下一步的去向
如果要将现有的本地 WEM 数据库迁移到 WEM 服务中，请参阅迁移到云。
要直接开始使用 WEM 服务，请启动管理控制台并根据需要在其中配置设置。有两个控制台可用：
我们正在将功能从旧版控制台迁移到 Web 控制台。Web 控制台的响应速度比传统控制台快，并提供更多功能。要查看仅在 Web 控制台中可用的功能，请参阅新增功能。
先决条件和建议
要确保 WEM 代理正常工作，请注意以下先决条件和建议：
必备条件
验证是否满足以下要求：
-
Windows 服务 系统事件通知服务 配置为在启动时自动启动。
-
WEM 代理服务 Citrix WEM Agent Host Service 和 Citrix WEM User Logon Service 配置为在启动时自动启动。
-
代理缓存尽可能驻留在持久的位置。使用非持久性缓存位置可能会导致潜在的缓存同步问题、过多的网络数据使用、性能问题等。
建议
请按照本节中的建议进行成功的代理部署：
-
例如，请勿使用登录或启动脚本手动操作 Citrix WEM Agent Host Service。诸如停止或重新启动 Citrix WEM Agent Host Service 之类的操作可能会停止 Netlogon 服务的工作，从而导致其他应用程序出现问题。
-
不要使用登录脚本启动 UI 模式或 CMD 模式代理。否则，某些功能可能无法正常工作。
代理启动行为
-
Citrix WEM Agent Host Service 在服务启动后自动重新加载通过组策略配置的 Cloud Connector 设置。
-
如果 Agent Host Service 在首次登录期间未启动，Citrix WEM Agent User Logon Service 将自动启动 Citrix WEM Agent Host Service。此行为可确保正确处理用户配置。
-
Citrix WEM Agent Host Service 在启动时自动对以下本地数据库文件执行检查：
LocalAgentCache.db和LocalAgentDatabase.db。如果已置备虚拟机并且本地数据库文件来自基础映像，则会自动清除数据库文件。 -
Citrix WEM Agent Host Service 启动时，它会自动验证代理本地缓存最近是否已更新。如果高速缓存在超过两个配置的缓存同步时间间隔内更新缓存，则会立即同步高速缓存。例如，假设默认代理缓存同步间隔为 30 分钟。如果在过去 60 分钟内未更新缓存，则会在 Citrix WEM Agent Host Service 启动后立即同步缓存。
-
在安装过程中，WEM 代理安装程序会将 Windows 服务 系统事件通知服务 配置为自动启动。
-
WEM 代理升级完成后，WEM 代理安装程序会自动启动 Netlogon 服务。
代理缓存实用程序选项
Citrix WEM Agent Host Service 会自动处理设置刷新和缓存同步。仅在需要立即刷新设置并同步缓存的情况下才使用代理缓存实用程序。
使用命令行在代理安装文件夹中运行 AgentCacheUtility.exe 。可执行文件接受以下命令行参数：
-
-help：显示允许的参数列表。 -
-RefreshCache或者-r：触发缓存构建或刷新。 -
-RefreshSettings或者-S：刷新代理主机设置。 -
-Reinitialize或者-I：与-RefreshCache选项一起使用时，重新初始化代理缓存。
有关如何使用命令行的详细信息，请参阅以下示例：
- 刷新代理主机设置：
AgentCacheUtility.exe -RefreshSettings
- 同时刷新代理主机设置和代理缓存：
AgentCacheUtility.exe -RefreshSettings -RefreshCache
- 重新初始化代理缓存：
AgentCacheUtility.exe -RefreshCache -Reinitialize
须知
代理可执行文件接受自定义参数，如下所述。
代理设置
有关 WEM 代理设置，请参阅下面的内容。
-
AgentLocation。用于指定代理安装位置。指定有效的文件夹路径。
-
CloudConnectorList。用于指定每个 Citrix Cloud Connector 的 FQDN 或 IP 地址。确保用逗号 (,) 分隔 FQDN 或 IP 地址。
-
VUEMAppCmdDelay。允许您指定代理应用程序启动器 (VUEMAppCmd.exe) 在 Citrix Virtual Apps and Desktops 发布的资源启动之前等待的时间。默认值为 0（毫秒）。为额外的同步延迟间隔键入的值必须是大于或等于零的整数。
-
AgentCacheLocation。用于指定代理缓存的替代位置。如果配置，代理本地缓存文件将保存在指定位置，而不是在代理安装文件夹中。
请注意以下事项：
-
如果通过命令行配置设置，则 WEM 代理安装程序将使用配置的设置。
-
如果设置未通过命令行配置，并且存在先前配置的设置，则安装程序将使用之前配置的设置。
-
如果设置未通过命令行配置，并且没有先前配置的设置，则安装程序将使用默认设置。
系统设置
有关与代理主机关联的系统设置，请参阅下文。
-
GpNetworkStartTimeoutPolicyValue。允许您配置在安装过程中创建的 GpNetworkStartTimeoutPolicyValue 注册表项的值（以秒为单位）。此参数指定组策略在登录时的策略处理期间等待网络可用性通知的时间。参数接受范围为 1（最小值）到 600（最大值）的任何整数。默认情况下，此值为 120。
-
SyncForegroundPolicy。允许您在代理安装期间配置 SyncForegroundPolicy 注册表值。此策略设置确定组策略处理是否同步。可接受的值：0，1。如果未设置该值或将值设置为 0，则 Citrix WEM Agent User Logon Service 不会延迟登录，并在后台处理用户组策略设置。如果将该值设置为 1，Citrix WEM Agent User Logon Service 将延迟登录，直到用户组策略设置的处理完成为止。默认情况下，该值在安装过程中不会更改。
重要：
如果在后台处理组策略设置，则 Windows 命令行管理程序 (Windows 资源管理器) 可能会在处理所有策略设置之前启动。因此，某些设置可能不会在用户第一次登录时生效。如果希望在用户首次登录时处理所有策略设置，请将值设置为 1。
-
WaitForNetwork。允许您配置在安装过程中创建的 WaitForNetwork 注册表项的值（以秒为单位）。此参数指定代理主机等待网络完全初始化和可用的时间。参数接受 0（最小值）到 300（最大值）范围内的任何整数。默认情况下，此值为 30。
以上所有三个注册表项都是在 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon 下创建的。这些密钥用于确保用户环境在登录之前收到基础结构服务器地址 GPO。在 Active Directory 或域控制器服务器响应速度较慢的网络环境中，这可能会导致出现登录屏幕之前额外的处理时间。Citrix 建议您将 GpNetworkStartTimeoutPolicyValue 注册表项的值设置为至少 30 个，以使其产生影响。
-
ServicesPipeTimeout。允许您配置 ServicesPipeTimeout 注册表项的值。注册表项是在安装过程中在 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control 下创建的。在允许服务控制管理器报告 WEM 代理服务的状态之前，此注册表项添加延迟。延迟可以防止代理服务在初始化网络之前启动，从而防止代理失败。此参数接受任何值，以毫秒为单位。如果未指定，则使用默认值 60000（60 秒）。
注意：
如果未使用命令行配置上述设置，则 WEM 代理安装程序在安装过程中不会处理这些设置。
示例
您还可以使用以下命令行格式配置设置：
"Citrix Workspace Environment Management Agent.exe" <key=value>
例如：
- 指定代理安装位置和 Citrix Cloud Connector
"Citrix Workspace Environment Management Agent.exe" /quiet AgentLocation="L:\WEM Agent" Cloud=1 CloudConnectorList=cc1.qa.local,cc2.qa.local
- 将“用户登录网络等待时间”设置为 60 秒
"Citrix Workspace Environment Management Agent.exe" WaitForNetwork=60