操作

Last published : Nov 13, 2026
提示：
  • 您可以使用 动态令牌 来扩展 WEM 操作，使其功能更强大。
  • 要将从 Citrix Environment Tool Hub 复制的数据粘贴到 Web 控制台，请确保浏览器允许数据复制。例如：对于 Microsoft Edge，请务必启用“站点权限 > 剪贴板 > 当网站想要查看复制到剪贴板的文本和图像时询问”选项。
Workspace Environment Management™ (WEM) 通过提供易于使用的操作来简化工作区配置过程。您可以使用分配使操作对用户可用。WEM 还为您提供筛选器以根据上下文调整您的分配。
Related information
配置集

组策略设置

重要提示：
  • Workspace Environment Management (WEM) 目前仅支持添加和编辑与 HKEY_LOCAL_MACHINE 和 HKEY_CURRENT_USER 注册表配置单元关联的组策略设置。
您可以通过 WEM 部署 GPO，而无需依赖 Active Directory 管理员使用“组策略管理”控制台来管理组策略对象 (GPO)。
开始之前，请添加或导入您的“组策略”设置。然后，通过将设置以 GPO 的形式分配给用户来部署它们。您可以通过指定要分配到的目标来管理每个 GPO 的分配。
启用此功能后：
  • 您可以配置您的设置。
  • WEM 代理可以处理组策略设置。
禁用此功能后：
  • 您无法配置组策略设置。
  • 即使组策略设置已分配给用户或用户组，WEM 代理也不会处理它们。
注意：
为了使 WEM 代理正确处理和应用组策略设置，请验证是否已在其上启用 Citrix WEM 用户登录服务。

基于注册表的设置

使用此选项卡通过配置注册表操作来配置 Windows 设置。
在配置集下的 操作 > 组策略设置 > 基于注册表 中，您可以执行以下操作：
  • 将基于注册表的组策略设置导入到 WEM 中。
  • 创建 GPO
  • 刷新 GPO 列表
  • 查看 GPO
  • 编辑 GPO
  • 管理 GPO 的分配
  • 克隆 GPO
  • 删除 GPO
警告：
错误地编辑、添加和删除基于注册表的设置可能会导致这些设置在用户环境中不生效。

导入组策略设置

您可以从包含 GPO 备份或导出的注册表文件的 zip 文件中导入 GPO。
从注册表文件导入设置时，您可以将使用 Windows 注册表编辑器导出的注册表值转换为 GPO，以便进行管理和分配。开始之前，请注意以下事项：
  • 从 zip 文件导入设置时，该文件可以包含一个或多个注册表文件。
  • 每个 .reg 文件都将转换为一个 GPO。您可以将每个转换后的 GPO 视为一组注册表设置。
  • 每个转换后的 GPO 的名称是根据相应的 .reg 文件的名称生成的。例如：如果 .reg 文件的名称是 test1.reg，则转换后的 GPO 的名称是 test1。
  • 此功能支持转换与您在 .reg 文件中定义的注册表项和值相关的删除操作。有关使用 .reg 文件删除注册表项和值的信息，请参阅 <https://support.microsoft.com/zh-cn/topic/how-to-add-modify-or-delete-registry-subkeys-and-values-by-using-a-reg-file-9c7f37cf-a5e9-e1cd-c4fa-2a26218a1a23>。
  • 转换后的 GPO 的描述为空。
要导入组策略设置，请完成以下步骤：
  1. 在操作栏中，单击 导入。
  2. 选择文件类型。
    • GPO 备份文件。如果要从 GPO 备份文件导入设置，请选择此选项。有关如何备份组策略设置的信息，请参阅 备份组策略设置。
    • 导出的注册表文件。如果要从使用 Windows 注册表编辑器导出的注册表文件导入设置，请选择此选项。
  3. 单击 浏览 以导航到您的 zip 文件。
    注意：
    您只能上传大小不超过 10 MB 的文件。
  4. 选择是否覆盖同名现有 GPO。
  5. 单击 导入 以开始导入过程。
导入成功完成后，导入的 GPO 将显示在 基于注册表 选项卡上。

创建 GPO

要创建 GPO，请完成以下步骤：
  1. 在操作栏中，单击“创建 GPO”。
  2. 指定 GPO 的名称。
  3. （可选）指定其他信息以帮助您识别 GPO。
  4. 单击“添加”以添加注册表操作。以下设置可用：
    • 操作。允许您指定注册表项的操作类型。
      • 设置值。允许您为注册表项设置值。
      • 删除值。允许您删除注册表项的值。
      • 创建项。允许您根据根项和子路径的组合创建项。
      • 删除项。允许您删除注册表项下的项。
      • 删除所有值。允许您删除注册表项下的所有值。
    • 根项。支持的值：HKEY_LOCAL_MACHINE 和 HKEY_CURRENT_USER。
    • 子路径。不包含根项的注册表项的完整路径。例如，如果 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows 是注册表项的完整路径，则 Software\Microsoft\Windows 是子路径。
    • 名称。允许您为注册表值指定名称。下图中的突出显示项整体是一个注册表值。将“名称”字段留空会将其设置为该项的默认值。
      注册表编辑器中的注册表值
    • 类型。允许您指定值的数据类型。
      • REG_SZ。此类型是用于表示人类可读文本值的标准字符串。
      • REG_EXPAND_SZ。此类型是可扩展数据字符串，其中包含一个变量，该变量在应用程序调用时将被替换。例如，对于以下值，字符串“%SystemRoot%”将被替换为操作系统中文件夹的实际位置。
      • REG_BINARY。任何形式的二进制数据。
      • REG_DWORD。一个 32 位数字。此类型通常用于布尔值。例如，0 表示禁用，1 表示启用。
      • REG_DWORD_LITTLE_ENDIAN。采用小端格式的 32 位数字。
      • REG_QWORD。一个 64 位数字。
      • REG_QWORD_LITTLE_ENDIAN。采用小端格式的 64 位数字。
      • REG_MULTI_SZ。此类型是多字符串，用于表示包含列表或多个值的值。每个条目都由一个空字符分隔。
      • REG_NONE。允许您配置不属于预定义数据类型类别的注册表值。
    • 数据。允许您键入与注册表值对应的数据。对于不同的数据类型，您可能需要以不同的格式键入不同的数据。
  5. 完成后，单击：
    • 完成。此操作完成 GPO 创建。
    • 保存并分配。此操作完成 GPO 创建并打开“分配”页面，您可以在其中继续分配创建的 GPO。

查看 GPO

您可以在只读模式下查看 WEM 组策略设置和 GPO 摘要，而无需编辑 GPO。此实现消除了在查看现有设置时出现错误配置的风险。
要查看 GPO，请完成以下步骤：
  1. 选择 GPO，然后在操作栏中单击“查看”。
  2. 查看名称、描述和注册表操作。
  3. 完成后，单击“关闭”。

编辑 GPO

要编辑 GPO，请完成以下步骤：
  1. 选择 GPO，然后在操作栏中单击“编辑”。
  2. 编辑名称和描述。创建或更新注册表项值时，将“名称”字段留空会将其设置为该项的默认值。
  3. 根据需要执行以下操作：
    • 单击“添加”以添加注册表操作
    • 选择一个注册表操作，然后对其进行编辑
    • 选择一个注册表操作，然后将其删除
    • 向下或向上移动注册表操作。或者，选择一个注册表操作，单击六点图标，然后将其拖动到所需位置。
  4. 完成后，单击“完成”。
注意：
如果 GPO 已分配给用户，则编辑它将影响这些用户。

管理 GPO 的分配

您可以将 GPO 分配给不同的 AD 组。一个组可以包含用户和计算机。如果相关计算机属于该组，则计算机级设置生效。如果当前用户属于该组，则用户级设置生效。
提示：
要使计算机级设置立即生效，请重新启动 Citrix WEM 代理主机服务。要使用户级设置立即生效，用户必须注销并重新登录。
要管理 GPO 的分配，请完成以下步骤：
  1. 创建 GPO 后，单击“保存并分配”按钮以完成创建并继续执行以下步骤。
  2. 选择 GPO，然后在操作栏中单击“管理分配”。
  3. 选择分配目标（用户、组和 OU）以分配 GPO。
    注意：
    将 GPO 分配给计算机时，请确保计算机位于 OU 或相关的安全组中。
    • 要添加新目标，请单击“添加新目标”。有关详细信息，请参阅添加分配目标。
  4. 使用筛选器使分配情境化，然后为每个目标设置 GPO 的优先级。
    提示：
    有关添加筛选器的信息，请参阅筛选器。组策略设置包括用户和计算机设置。某些筛选条件仅适用于用户设置。如果将这些条件应用于计算机设置，WEM 代理在分配设置之前评估筛选器时会跳过它们。有关不适用于计算机设置的条件的完整列表，请参阅不适用于计算机设置的条件。
  5. 单击每个磁贴上的省略号图标，并根据需要执行以下操作：
    • 复制配置。允许您复制分配的配置。
    • 粘贴配置。允许您粘贴从其他配置复制的配置。
    • 将此配置应用于所有目标。允许您将分配的配置应用于所有目标。
  6. 完成后，单击保存。

克隆 GPO

要克隆 GPO，请完成以下步骤：
  1. 选择 GPO，然后单击操作栏中的克隆。
  2. 编辑名称和描述。
  3. 选择要将 GPO 克隆到的配置集。
  4. 单击克隆以开始克隆过程。

删除 GPO

要删除 GPO，请选择它，然后单击操作栏中的删除。
注意：
如果 GPO 已分配给用户，删除它将影响这些用户。

基于模板的设置

使用此选项卡通过使用组策略管理模板配置 Windows 设置。您可以在计算机和用户级别配置 GPO。
在配置集下的操作 > 组策略设置 > 基于模板中，您可以执行以下操作：
  • 使用模板创建 GPO。
  • 管理模板。
  • 导入模板。
  • 刷新 GPO 列表。
  • 编辑 GPO。
  • 管理 GPO 的分配。
  • 克隆 GPO。
  • 删除 GPO。

使用模板创建 GPO

要使用模板创建 GPO，请完成以下步骤：
  1. 在操作栏中，单击创建 GPO。
  2. 在基本信息中：
    • 指定 GPO 的名称。
    • （可选）指定其他信息以帮助您识别 GPO。
  3. 在计算机配置中，配置要应用于计算机的策略（无论谁登录到计算机）。
  4. 在用户配置中，配置要应用于用户的策略（无论他们登录到哪台计算机）。
  5. 在“摘要”中，查看您所做的更改。
  6. 完成后，单击“完成”。
在“计算机配置”和“用户配置”中，选择一个设置进行配置。您可以以树视图和列表视图显示策略。在列表视图中，策略按字母顺序排序，您可以搜索所需的策略。
要配置设置，首先要启用它。一个设置可能包含多个可配置项。根据所需的输入类型，设置可以是复选框、输入框（文本或数字作为输入）、选择、列表或组合。
有关这些设置的信息，请从 Microsoft 下载 GPO 参考表。

管理模板

要管理模板，请完成以下步骤：
  1. 在操作栏中，单击“管理模板”。
  2. 在“管理模板”向导中：
  • 选择“计算机配置”以配置要应用于计算机的策略（无论谁登录到计算机）。
  • 选择“用户配置”以配置要应用于用户的策略（无论他们登录到哪台计算机）。
  1. 完成后，单击“完成”。
在“计算机配置”和“用户配置”中，选择一个设置进行配置。您可以以树视图和列表视图显示策略。在列表视图中，策略按字母顺序排序，您可以搜索所需的策略。
要配置设置，首先要启用它。一个设置可能包含多个可配置项。根据所需的输入类型，设置可以是复选框、输入框（文本或数字作为输入）、选择、列表或组合。
有关这些设置的信息，请从 Microsoft 下载 GPO 参考表。

导入模板

重要提示：
将 ADMX 文件导入 WEM 用作模板时，请确保 zip 文件中的所有 .adml 文件都使用相同的语言。
您可以将 ADMX 文件导入 WEM 用作模板。然后，您可以使用这些模板创建 GPO。要导入模板，请完成以下步骤：
  1. 在操作栏中，单击 管理模板。
  2. 在 管理模板 向导中，单击 导入。
  3. 浏览到包含 ADMX 文件的 zip 文件，并决定如果文件包含与现有模板同名的模板时要执行的操作：
    • 不导入。取消导入。
    • 跳过此模板并导入其余模板。
    • 覆盖现有模板。覆盖可能会更改源自现有模板的关联设置。使用这些模板创建的现有 GPO 不受影响。但是，当您编辑这些 GPO 时，关联的设置将丢失。
  4. 单击 开始导入 以开始导入过程。
  5. 完成后，单击 完成 返回到 管理模板 向导。
  6. 在此处管理模板，或单击 完成 退出。
有关如何管理导入的模板文件的信息，请参阅 文件。在此处管理它们时，请考虑以下事项：
  • 删除 GPO 管理模板文件将从当前模板中删除关联设置。使用这些模板创建的现有 GPO 不受影响。但是，当您编辑这些 GPO 时，关联的设置将丢失。

查看 GPO

您可以在只读模式下查看 WEM 组策略设置和 GPO 摘要，而无需编辑 GPO。此实现消除了在查看现有设置时发生错误配置的风险。
要查看 GPO，请完成以下步骤：
  1. 选择 GPO，然后单击操作栏中的“查看”。
  2. 查看名称、描述和配置。
  3. 完成后，单击“关闭”。

编辑 GPO

要编辑 GPO，请完成以下步骤：
  1. 选择 GPO，然后单击操作栏中的“编辑”。
  2. 在“基本信息”中，编辑名称和描述。
  3. 在“计算机配置”中，编辑计算机策略。
  4. 在“用户配置”中，编辑用户策略。
  5. 在“摘要”中，查看您所做的更改。
  6. 完成后，单击“保存”。
注意：
如果 GPO 已分配给用户，则编辑它将影响这些用户。

管理 GPO 的分配

您可以像管理基于注册表的 GPO 一样，管理使用模板创建的 GPO 的分配。有关详细信息，请参阅管理 GPO 的分配。

克隆 GPO

要克隆 GPO，请完成以下步骤：
  1. 选择 GPO，然后在操作栏中单击克隆。
  2. 决定是将 GPO 克隆为基于注册表的 GPO 还是基于模板的 GPO。
    注意：
    克隆为基于注册表的 GPO 时，GPO 将转换为注册表值并显示在基于注册表选项卡上。您可以将每个转换后的 GPO 视为一组注册表设置。
  3. 编辑名称和描述。
  4. 选择要将 GPO 克隆到的配置集。
  5. 单击克隆以开始克隆过程。

删除 GPO

要删除 GPO，请选择它，然后在操作栏中单击删除。
注意：
如果 GPO 已分配给用户，则删除它会影响这些用户。

应用程序

此功能允许您添加要分配给用户的应用程序。分配后，这些应用程序的快捷方式会根据您的配置在桌面、开始菜单或任务栏上创建。
提示：
您可以使用 Citrix DaaS 的“完全配置”管理控制台编辑应用程序设置，然后添加指向 VUEMAppCmd.exe 的可执行文件路径。VUEMAppCmd.exe 可确保 Workspace Environment Management 代理在 Citrix DaaS 和 Citrix Virtual Apps and Desktops 发布的应用程序启动之前完成环境处理。有关详细信息，请参阅使用“完全配置”管理界面编辑应用程序设置。
您可以执行以下操作：
  • 添加应用程序。
  • 刷新应用程序列表。
  • 编辑应用程序以管理其属性。
  • 管理应用程序的分配。
  • 克隆应用程序。
  • 删除应用程序。
  • 切换到“开始”菜单视图。
  • 指定代理如何处理应用程序。
添加和分配应用程序的一般工作流程如下：
  1. 在 Web 控制台中，转到相关配置集，导航到 操作 > 应用程序，然后单击 添加应用程序。请参阅 添加应用程序。
  2. 选择您添加的应用程序，然后单击操作栏中的 管理分配。请参阅 管理应用程序的分配。
分配生效需要一些时间，具体取决于您在 高级设置 中为 SQL 设置刷新延迟指定的值。要使分配立即生效，请完成以下步骤：
  1. 转到 Web 控制台 > 监视 > 管理 > 代理 > 统计信息，然后选择代理。
  2. 单击操作栏中的 更多，然后选择 代理 > 刷新代理主机设置。
重要提示：

添加应用程序

要添加应用程序，请完成以下步骤：
  1. 在应用程序中，单击添加应用程序。
  2. 在基本信息页面上，配置以下设置：
    • 名称。指定一个名称以帮助您识别应用程序。
    • 描述。指定有关应用程序的其他信息。
    • 状态。启用或禁用应用程序，或将其置于维护模式。处于维护模式时，应用程序不可用。其快捷方式图标包含一个警告标志，表示它不可用。
    • 应用程序类型。指定快捷方式打开的应用程序类型。用户界面会因您的选择而异。
      • 已安装的应用程序。创建打开用户计算机上已安装应用程序的快捷方式。如果选中，系统会提示您完成以下操作：
        • 应用程序路径。键入用户计算机上应用程序的完整路径。
        • 工作文件夹。键入用户计算机上某个文件夹的完整路径作为应用程序的工作文件夹。在应用程序路径字段中键入完整路径后，此字段会自动填充。
        • 参数。如果需要，键入应用程序的启动参数。
    • 文件或文件夹。允许您创建一个快捷方式，当用户单击快捷方式图标时，该快捷方式会在用户计算机上打开目标文件或文件夹。如果选中，系统会提示您完成以下操作：
      • 路径。键入目标文件或文件夹的完整路径。
    • URL。允许您添加应用程序的 URL。如果选中，系统会提示您完成以下操作：
      • 应用程序 URL。键入应用程序的 URL。
    • Citrix Workspace™ 资源。允许您从 Citrix Workspace 添加应用程序。如果选中，系统会提示您完成以下操作：
      • 应用商店 URL。键入 StoreFront™ 或 Workspace 应用商店的 URL，其中包含您要从应用程序快捷方式启动的资源。
      注意：
      您无法在代理计算机上打开 SaaS 应用程序或某些 Citrix Workspace (Storefront) 资源类型的应用程序。
      • 资源。使用 Citrix Environment Tool Hub > Application Assistant 浏览到目标 Workspace 资源。单击粘贴资源信息，复制资源信息并将其粘贴到此处。单击打开应用程序助手以打开 Citrix Environment Tool Hub（如果已安装）。要下载 Citrix Environment Tool Hub，请转至 Citrix Cloud > WEM service > Utilities。有关详细信息，请参阅Citrix Environment Tool Hub。
  3. 在选项页面上，配置以下设置：
    • 应用程序图标。单击更改以选择其他图标或添加新图标。
      • 要添加新图标，请浏览到 .ico 文件或粘贴从 Citrix Environment Tool Hub > Application Assistant 复制的图标数据。WEM 支持保存多达 100 个图标。有关详细信息，请参阅Citrix Environment Tool Hub。
    • 在用户桌面上设置图标位置。指定应用程序快捷方式在用户桌面上的目标位置。值以像素为单位。如果移动，快捷方式将在下次登录时恢复到指定位置。
    • 显示名称。指定快捷方式的名称。该名称显示在用户环境中。
    • “开始”菜单集成。单击更改以指定在“开始”菜单左侧创建应用程序快捷方式的位置。默认情况下，新快捷方式在程序中创建。在**“开始”菜单集成**窗口中，您可以执行以下操作：
      • 为快捷方式创建自定义文件夹。
      • 指定应用程序快捷方式在“开始”菜单文件夹中的位置。
      • 重命名自定义文件夹。
      注意：
      要删除自定义文件夹，请转到“应用程序”中的“开始菜单视图”。请参阅切换到“开始”菜单视图。
    • 窗口样式。指定应用程序在用户计算机上是以最小化（最小化到任务栏）、正常（正常屏幕视图）还是最大化（全屏视图）窗口打开。
    • 热键。要设置热键，请单击输入字段并按下组合键。或者按以下格式输入组合键（例如）：Ctrl + Alt + S
    • 启用自动还原。如果启用，代理会在刷新时自动重新创建快捷方式（如果已移动或删除）。
    • 在代理菜单中隐藏应用程序。指定是在可从用户计算机访问的代理菜单中显示还是隐藏应用程序。
    • 在用户的“收藏夹”文件夹中创建快捷方式。指定是否在用户的“收藏夹”文件夹中创建应用程序快捷方式。
  4. 完成后，单击“完成”以保存并退出。

编辑应用程序

要编辑应用程序，请完成以下步骤：
  1. 在“应用程序”中，选择应用程序。如果需要，请使用搜索框快速查找应用程序。
  2. 在操作栏中单击“编辑”。
  3. 在“基本信息”和“选项”页面上，根据需要进行更改。
  4. 完成后，单击“保存”。

管理应用程序的分配

要管理应用程序的分配，请完成以下步骤：
  1. 选择应用程序，然后在操作栏中选择“管理分配”。
  2. 选择分配目标（用户和组）以将应用程序分配给它们。
  • 要添加新目标，请单击“添加新目标”。有关详细信息，请参阅添加分配目标。
  • 配置目标以指定要使用的筛选器以及在何处创建应用程序快捷方式：
    • 创建桌面快捷方式
    • 添加到“开始”菜单
    • 固定到“开始”菜单
    • 添加到快速启动
    • 添加到 Windows 启动
    • 固定到任务栏
  1. 使用筛选器使分配具有上下文。
    • 有关添加筛选器的信息，请参阅筛选器。
  2. 完成后，点击 完成。

克隆应用程序

注意：
不克隆分配。
要克隆应用程序，请完成以下步骤：
  1. 选择应用程序，然后在操作栏中选择 克隆。
  2. 编辑名称和描述。
  3. 选择要将应用程序克隆到的配置集。
  4. 点击 克隆 以开始克隆过程。

删除应用程序

要删除应用程序，请选择它，然后在操作栏中选择 删除。
注意：
如果应用程序已分配给用户，删除它将影响这些用户。

切换到“开始”菜单视图

要切换到 “开始”菜单视图，请点击 “开始”菜单视图。该视图显示每个应用程序在“开始”菜单文件夹中的位置。您可以执行以下操作：
  • 创建自定义文件夹。
  • 将应用程序移动到所需文件夹。
  • 重命名自定义文件夹。
  • 删除自定义文件夹。删除自定义文件夹时，文件夹中的应用程序也将被删除。

指定代理如何处理应用程序

处理：
  • 在登录和刷新时处理应用程序
  • 在重新连接时处理应用程序
  • 取消分配时从桌面删除应用程序
  • 强制处理应用程序
  • 强制处理应用程序的筛选器
StoreFront：
  • 添加 StoreFront URL，如果需要，为其输入说明。添加类型为“Citrix Workspace 资源”的应用程序时需要此 URL。请参阅添加应用程序。

外部任务

提示：
外部任务在用户会话级别运行。要在计算机级别运行任务，请改用脚本化任务。
此功能允许您创建外部任务以分配给用户。外部任务在用户会话级别运行，可以是脚本或应用程序。请确保目标代理计算机具有运行它们所需的程序。常用的脚本包括：.vbs 和 .cmd 脚本。
您可以指定何时运行外部任务，以便精确有效地管理用户环境。
您可以执行以下操作：
提示：
您可以使用“状态”列中的切换开关快速启用或禁用外部任务。要启用任务，请为其配置至少 1 个触发器。

创建外部任务

要创建任务，请完成以下步骤：
  1. 在“外部任务”中，单击“创建外部任务”。
  2. 在“任务”选项卡上，配置以下设置。
    • 名称。指定一个名称以帮助您识别任务。
    • 描述。指定有关任务的其他信息。
    • 启用此任务。控制任务是启用还是禁用。禁用时，即使任务已分配给用户，代理也不会处理该任务。
    • 任务详细信息
      • 运行脚本。支持的脚本类型（文件类型）为 .ps1、.vbs、.cmd、.bat、.py。您可以通过选择查看内容来查看脚本，甚至可以通过单击替换来替换脚本。但是，如果脚本大于 1 MB，并且您选择了无效或不支持的文件/脚本格式，则会引发错误。
        • 用于运行脚本的程序。输入用于运行脚本的程序的路径。此字段仅在上传的脚本是扩展名为 .py 的 Python 脚本时显示。
        • 参数。输入参数。此条目是可选的。
        • 工作文件夹。输入工作文件夹。此条目也是可选的。
      • 运行命令。
        • 路径。输入任务的路径或浏览到任务。路径在用户环境中解析。请确保：
          • 您在此处指定的路径与目标代理计算机一致。
          • 目标代理计算机具有运行任务的相应程序。
        • 参数。指定启动参数或参数。您可以键入一个字符串。该字符串包含要传递给目标脚本或应用程序的参数。有关使用路径和参数字段的示例，请参阅外部任务示例。此条目是可选的。
        • 工作文件夹。输入工作文件夹。此条目也是可选的。
    • 任务设置
      • 隐藏运行。如果选中，任务将在后台运行，用户不可见。
      • 运行一次。如果选中，无论您在触发器中选择哪些选项，也无论代理是否重新启动，WEM 都只运行一次任务。
      • 执行顺序。当您为用户分配了多个任务，并且某些任务依赖于其他任务才能成功运行时，请使用此选项。执行顺序值为 0（零）的任务首先运行，然后是值为 1 的任务，然后是值为 2 的任务，依此类推。
      • 等待任务完成。指定代理等待任务完成的时间。默认情况下，等待超时值为 30 秒。如果任务是基于脚本的，您可以选择收集任务输出报告以从任务中收集输出数据。
  3. 在“触发器”选项卡上，选择要与任务关联的触发器。
    注意：
    并非所有触发器都可以与外部任务关联。请参阅注意事项。
    • 创建新触发器。请参阅创建触发器。
    • 仅显示适用于此任务的触发器。筛选掉不适用于该任务的触发器。
  4. 完成后，单击“完成”以保存并退出。

注意事项

外部任务在会话级别工作。您只能将以下触发器与外部任务关联。请参阅以下触发器支持性矩阵表，其中列出了任务支持的触发器。
脚本化任务 外部任务
代理刷新 X
重新连接 X
登录 X
注销 X
断开连接 X
锁定 X
解锁 X
计算机启动 X
计算机关机 X
已计划 X X
进程已启动 X
进程已结束 X
Windows 事件 X X
云健康检查结果 X
配置文件管理健康检查结果 X
自定义脚本任务 X
  • 内置触发器：
    • 代理刷新
    • 重新连接
    • 登录
    • 注销
    • 断开连接
    • 锁定
    • 解锁
    • 计算机启动
    • 计算机关机
  • Windows 触发器：
    • 事件
  • 计划的触发器：
  • 用户进程触发器：
    • 进程已启动
    • 进程已结束
使用内置触发器 重新连接 时，请考虑以下事项：
  • 如果 WEM 代理安装在物理 Windows 设备上，则此选项不适用。
使用断开连接、锁定和解锁触发器时，请考虑以下事项：
  • 断开连接、锁定和解锁的实现基于 Windows 事件。在某些环境中，这些选项可能无法按预期工作。例如，在运行 Windows 10 或 Windows 11 单会话 VDA 的桌面中，断开连接选项不起作用。请改用锁定选项。（在这种情况下，我们收到的操作是“锁定”。）
  • 建议您将这些触发器与 UI 代理一起使用。原因有二：
    • 当您将它们与 CMD 代理一起使用时，每次发生相应事件时，代理都会在用户环境中启动，以检查外部任务是否运行。
    • CMD 代理在并发任务场景中可能无法最佳运行。
借助用户进程触发器，您可以定义外部任务，以便仅在某些进程运行时提供资源，并在进程结束时撤销这些资源。与在登录或注销时处理外部任务相比，使用进程作为外部任务的触发器可以更精确地管理用户环境。在使用用户进程触发器之前，请验证是否满足以下先决条件：
  • WEM 代理以 UI 模式启动并运行。
  • 指定的进程与登录用户在同一用户会话中运行。
  • 为了使配置的外部任务保持最新，请务必在“高级设置 > 配置 > 高级选项”选项卡上选择“启用自动刷新”。
使用 Windows 事件触发器时，请考虑以下事项：
  • 只有记录了用户名的 Windows 事件才能用于触发外部任务。
  • WEM 代理以 UI 模式打开并运行。

编辑外部任务

要编辑任务，请执行以下步骤：
  1. 在“外部任务”中，选择任务。如有需要，可使用搜索框快速查找任务。
  2. 在操作栏中单击“编辑”。
  3. 在“任务”和“触发器”选项卡上，根据需要进行更改。
  4. 完成后，单击“完成”。

管理外部任务的分配

要管理外部任务的分配，请完成以下步骤：
  1. 选择任务，然后在操作栏中选择“管理分配”。
  2. 选择分配目标（用户和组）以分配任务。
    • 要添加新目标，请单击“添加新目标”。有关详细信息，请参阅添加分配目标。
  3. 使用筛选器来根据上下文调整分配。
    • 有关添加筛选器的信息，请参阅筛选器。
  4. 完成后，单击完成。

克隆外部任务

注意：
触发器关联和分配不会被克隆。
要克隆任务，请完成以下步骤：
  1. 选择任务，然后在操作栏中选择克隆。
  2. 编辑名称和描述。
  3. 选择要将任务克隆到的配置集。
  4. 单击克隆以开始克隆过程。

删除外部任务

要删除任务，请选择它，然后在操作栏中选择删除。
注意：
如果外部任务已分配给用户，则删除它将影响这些用户。

启用并查看基于脚本的外部任务的报告

注意：
对于外部任务，报告仅适用于基于脚本的任务。
您可以配置 Workspace Environment Management 以生成和显示基于脚本的外部任务的报告。有两种类型的报告可用：操作处理结果和操作处理事件。

启用外部任务报告

要为基于脚本的外部任务启用报告，请完成以下设置：
  1. 转到 高级设置 > 监视首选项 > 操作处理结果，然后选择 外部任务。
  2. 创建此外部任务时，同时启用 等待任务完成 和 收集任务输出报告。

查看外部任务的处理结果

操作处理结果报告显示了每个已启用报告的基于脚本的外部任务的最终状态，指示其是成功完成还是遇到错误。
要查看报告：
  1. 转到 监视 > 报告。
  2. 应用 事件类型为操作处理结果 筛选器。
  3. 在出现的 操作处理结果 页面上，选择 外部任务 选项卡。

查看外部任务的事件详细信息

操作处理事件报告提供了每个已启用报告的基于脚本的外部任务的详细信息。详细信息包括：
  • 任务结果
  • 运行任务的代理
  • 触发任务的用户
  • 配置集名称
  • 捕获的控制台输出
要查看报告：
  1. 转到监控 > 报告。
  2. 应用事件类型是操作处理事件筛选器。

打印机

此功能允许您将打印机添加为可分配的操作。分配后，这些打印机可在用户的桌面中使用。
您可以执行以下操作：
  • 添加打印机。
  • 从打印服务器添加打印机。
  • 刷新打印机列表。
  • 编辑打印机。
  • 管理打印机的分配。
  • 克隆打印机。
  • 删除打印机。
  • 指定代理如何处理打印机。
添加和分配打印机的一般工作流程如下：
  1. 在 Web 控制台中，转到相关的配置集，导航到 Actions > Printers，然后单击 Add printer。请参阅添加打印机。
  2. 选择您添加的打印机，然后在操作栏中单击 Manage assignments。请参阅管理打印机分配。
分配需要一些时间才能生效。要立即生效，请参阅使分配立即生效。

添加打印机

要添加打印机，请完成以下步骤：
  1. 在 Printers 中，单击 Add printer。
  2. 指定操作类型。界面会根据所选操作类型而有所不同。
    • 映射网络打印机。
      • 名称。指定一个名称以帮助您识别打印机。
      • 描述（可选）。指定有关打印机的其他信息。
      • 启用此打印机。启用或禁用打印机。禁用后，即使分配给用户，代理也不会处理它。
      • 打印机路径。指定打印机在用户环境中解析的路径。
      • 使用特定凭据连接。默认情况下，代理使用其运行所在的 Windows 帐户连接到打印机。如果用户必须为连接指定不同的凭据，请选择此选项。
      • 显示名称。指定打印机的名称。该名称显示在用户环境中。
      • 启用自动还原。如果启用，代理会在刷新时自动重新创建打印机（如果已删除）。
    • 使用打印机映射文件。
      • 名称。指定一个名称以帮助您识别打印机。
      • 描述（可选）。指定有关打印机的其他信息。
      • 启用此打印机。启用或禁用打印机。禁用时，即使已分配给用户，代理也不会处理它。
      • 文件路径。您可以使用 XML 打印机列表文件为用户配置打印机。将文件放置在用作映像的代理计算机上。代理刷新时，它会解析 XML 文件以查找要添加到操作队列的打印机。请参阅 XML 打印机列表配置。
  3. 完成后，单击“完成”以保存并退出。

从打印服务器添加打印机

要从网络打印服务器添加打印机，请在“Citrix Environment Tool Hub > Printer Assistant”中查找所需的打印机，复制其信息，然后粘贴。请参阅 Citrix Environment Tool Hub。

编辑打印机

要编辑打印机，请完成以下步骤：
  1. 在“打印机”中，选择打印机。如果需要，请使用搜索框快速查找打印机。
  2. 在操作栏中单击“编辑”。
  3. 根据需要进行更改。
  4. 完成后，单击“保存”。

管理打印机的分配

要管理打印机的分配，请完成以下步骤：
  1. 选择打印机，然后在操作栏中选择“管理分配”。
  2. 选择要分配打印机的分配目标（用户和组）。
    • 要添加新目标，请单击“添加新目标”。有关详细信息，请参阅添加分配目标。
    • 配置目标以指定要使用的筛选器以及是否将其设置为默认打印机。有关添加筛选器的信息，请参阅筛选器。
  3. 完成后，单击“完成”。

克隆打印机

注意：
不克隆分配。
要克隆打印机，请完成以下步骤：
  1. 选择打印机，然后在操作栏中选择“克隆”。
  2. 编辑名称和描述。
  3. 选择要将打印机克隆到的配置集。
  4. 单击“克隆”以开始克隆过程。

删除打印机

要删除打印机，请选择它，然后在操作栏中选择“删除”。
注意：
如果打印机已分配给用户，则删除它会影响这些用户。

指定代理如何处理打印机

处理选项：
  • 在登录和刷新时处理打印机
  • 在重新连接时处理打印机
  • 取消分配时从桌面删除打印机
  • 强制处理打印机
  • 强制处理打印机筛选器
  • 异步处理打印机（如果启用，代理将异步处理打印机，而无需等待其他操作处理完成）

网络驱动器

此功能允许您将网络驱动器添加为可分配的操作。分配后，这些网络驱动器可在用户的桌面中使用。
您可以执行以下操作：
  • 添加网络驱动器。
  • 刷新网络驱动器列表。
  • 编辑网络驱动器。
  • 管理网络驱动器的分配。
  • 克隆网络驱动器。
  • 删除网络驱动器。
  • 指定代理如何处理网络驱动器。
添加和分配网络驱动器的一般工作流程如下：
  1. 在 Web 控制台中，转到相关配置集，导航到 操作 > 网络驱动器，然后单击 添加网络驱动器。请参阅添加网络驱动器。
  2. 选择您添加的网络驱动器，然后在操作栏中单击 管理分配。请参阅管理网络驱动器的分配。
分配需要一些时间才能生效。要立即生效，请参阅使分配立即生效。

添加网络驱动器

要添加网络驱动器，请完成以下步骤：
  1. 在 网络驱动器 中，单击 添加网络驱动器。
  2. 配置以下设置：
    • 名称。指定一个名称以帮助您识别网络驱动器。
    • 描述（可选）。指定有关网络驱动器的其他信息。
    • 启用此网络驱动器。启用或禁用网络驱动器。禁用后，即使已分配给用户，代理也不会对其进行处理。
    • 目标路径。指定网络驱动器在用户环境中解析的路径。
    • 使用特定凭据连接。默认情况下，代理使用其运行所在的 Windows 帐户连接到网络驱动器。如果用户必须为连接指定不同的凭据，请选择此选项。
    • 显示名称。指定网络驱动器的名称。该名称显示在用户环境中。
    • 启用自动还原。如果启用，代理会在刷新时自动重新创建网络驱动器（如果已删除）。
    • 设置为主驱动器。如果启用，网络驱动器将设置为主驱动器。
  3. 完成后，单击“完成”以保存并退出。

编辑网络驱动器

要编辑网络驱动器，请完成以下步骤：
  1. 在“网络驱动器”中，选择网络驱动器。如果需要，请使用搜索框快速查找网络驱动器。
  2. 单击操作栏中的“编辑”。
  3. 根据需要进行更改。
  4. 完成后，单击“保存”。

管理网络驱动器的分配

要管理网络驱动器的分配，请完成以下步骤：
  1. 选择网络驱动器，然后在操作栏中选择 管理分配。
  2. 选择分配目标（用户和组），以将网络驱动器分配给他们。
    • 要添加新目标，请单击 添加新目标。有关详细信息，请参阅 添加分配目标。
    • 配置目标以指定要使用的筛选器和驱动器号。有关添加筛选器的信息，请参阅 筛选器。
  3. 完成后，单击 完成。

克隆网络驱动器

注意：
分配不会被克隆。
要克隆网络驱动器，请完成以下步骤：
  1. 选择网络驱动器，然后在操作栏中选择 克隆。
  2. 编辑名称和描述。
  3. 选择要将网络驱动器克隆到的配置集。
  4. 单击 克隆 以开始克隆过程。

删除网络驱动器

要删除网络驱动器，请选择它，然后在操作栏中选择 删除。
注意：
如果网络驱动器已分配给用户，则删除它将影响这些用户。

指定代理如何处理网络驱动器

处理选项：
  • 在登录和刷新时处理网络驱动器
  • 在重新连接时处理网络驱动器
  • 当取消分配时从桌面删除网络驱动器
  • 强制处理网络驱动器
  • 强制处理网络驱动器的筛选器
  • 异步处理网络驱动器。如果启用，代理将异步处理网络驱动器，而无需等待其他操作处理完成。
驱动器号：
  • 不用于分配的驱动器号。在分配驱动器资源时，任何选定的驱动器号都将从驱动器号选择中排除。
  • 允许在分配中重复使用驱动器号。如果启用，在分配中使用的驱动器号仍可供分配给同一目标的其它驱动器使用。

虚拟驱动器

此功能允许您将虚拟驱动器添加为可分配的操作。分配后，这些虚拟驱动器可在用户的桌面中使用。
您可以执行以下操作：
  • 添加虚拟驱动器。
  • 刷新虚拟驱动器列表。
  • 编辑虚拟驱动器。
  • 管理虚拟驱动器的分配。
  • 克隆虚拟驱动器。
  • 删除虚拟驱动器。
  • 指定代理如何处理虚拟驱动器。
添加和分配虚拟驱动器的一般工作流程如下：
  1. 在 Web 控制台中，转到相关配置集，导航到 操作 > 虚拟驱动器，然后单击 添加虚拟驱动器。请参阅 添加虚拟驱动器。
  2. 选择您添加的虚拟驱动器，然后在操作栏中单击 管理分配。请参阅 管理虚拟驱动器的分配。
分配需要一些时间才能生效。要立即生效，请参阅 使分配立即生效。

添加虚拟驱动器

要添加虚拟驱动器，请完成以下步骤：
  1. 在 虚拟驱动器 中，单击 添加虚拟驱动器。
  2. 配置以下设置：
    • 名称。指定一个名称以帮助您识别虚拟驱动器。
    • 描述（可选）。指定有关虚拟驱动器的其他信息。
    • 启用此虚拟驱动器。启用或禁用虚拟驱动器。禁用时，即使已分配给用户，代理也不会对其进行处理。
    • 目标路径。指定虚拟驱动器在用户环境中解析的路径。
    • 设置为主驱动器。如果启用，则将网络驱动器设置为主驱动器。
  3. 完成后，单击“完成”以保存并退出。

编辑虚拟驱动器

要编辑虚拟驱动器，请完成以下步骤：
  1. 在“虚拟驱动器”中，选择虚拟驱动器。如果需要，请使用搜索框快速查找虚拟驱动器。
  2. 在操作栏中单击“编辑”。
  3. 根据需要进行更改。
  4. 完成后，单击“保存”。

管理虚拟驱动器的分配

要管理虚拟驱动器的分配，请完成以下步骤：
  1. 选择虚拟驱动器，然后在操作栏中选择“管理分配”。
  2. 选择分配目标（用户和组）以分配虚拟驱动器。
    • 要添加新目标，请单击“添加新目标”。有关详细信息，请参阅添加分配目标。
    • 配置目标以指定要使用的筛选器和驱动器号。有关添加筛选器的信息，请参阅筛选器。
      重要提示：
      “下一个可用”和“未分配字母”选项仅适用于网络驱动器。
  3. 完成后，单击完成。

克隆虚拟驱动器

注意：
不克隆分配。
要克隆虚拟驱动器，请完成以下步骤：
  1. 选择虚拟驱动器，然后在操作栏中选择克隆。
  2. 编辑名称和描述。
  3. 选择要将虚拟驱动器克隆到的配置集。
  4. 单击克隆以开始克隆过程。

删除虚拟驱动器

要删除虚拟驱动器，请选择它，然后在操作栏中选择删除。
注意：
如果虚拟驱动器已分配给用户，则删除它会影响这些用户。

指定代理如何处理虚拟驱动器

处理选项：
  • 在登录和刷新时处理虚拟驱动器
  • 在重新连接时处理虚拟驱动器
  • 取消分配时从桌面删除虚拟驱动器
  • 强制处理虚拟驱动器的筛选器
  • 强制处理虚拟驱动器的筛选器
驱动器号：
  • 不用于分配的驱动器号。在分配驱动器资源时，任何选定的驱动器号都将从驱动器号选择中排除。
  • 允许在分配中重复使用驱动器号。如果启用，分配中使用的驱动器号仍可供分配给同一目标的其它驱动器使用。

注册表项

此功能允许您创建、设置、删除注册表值，并将其分配以创建或修改注册表。您可以为注册表项添加标签，并同时分配多个注册表项。
您可以执行以下操作：
  • 添加注册表项
  • 刷新注册表项列表
  • 编辑一个或多个注册表项
  • 管理一个或多个注册表项的分配
  • 克隆注册表项
  • 通过 reg 文件导入注册表项
  • 删除注册表项
  • 删除标签
添加和分配注册表项的常规工作流程如下：
  1. 在 Web 控制台中，转到相关的配置集。导航到 Actions > Registry entries，然后单击 Add registry entry。有关详细信息，请参阅添加注册表项。
  2. 选择您添加的注册表项，然后在操作栏中单击 Manage assignments。有关详细信息，请参阅管理单个或多个注册表项的分配。
分配需要一些时间才能生效。要立即生效，请参阅使分配立即生效。

添加注册表项

要添加注册表项，请完成以下步骤：
  1. 在注册表项中，单击 Add registry entry。
  2. 配置以下设置：
    • 操作类型。描述资源的动作类型。
    • 名称。指定一个名称以帮助您识别注册表项。创建注册表项值时，将“名称”字段留空会将其设置为该项的默认值。
    • 描述（可选）。指定有关注册表项的其他信息。
    • 标签。您可以为注册表项创建新标签或选择现有标签，然后可以使用这些标签批量管理注册表项。
    • 启用此操作。启用或禁用注册表项。禁用后，即使已分配给用户或计算机，代理也不会处理它。
    • 注册表路径。指定注册表项的注册表路径。
    • 值名称。注册表值在注册表中的名称（例如，NoNtSecurity）。
    • 类型。可能创建的注册表项的类型。
    • 数据。注册表项创建后的值（例如，0 或 C:\Program Files）。
    • 运行一次。如果选中，WEM 只运行一次此操作。
  3. 完成后，单击“完成”以保存并退出。

编辑一个或多个注册表项

要编辑一个或多个注册表项，请完成以下步骤：
  1. 在注册表项中，选择一个或多个注册表项。如有需要，可以使用搜索框或标记列表快速查找注册表项。
  2. 单击操作栏中的“编辑”。
  3. 根据需要进行更改。
  4. 完成后，单击“保存”。

管理一个或多个注册表项的分配

要管理一个或多个注册表项的分配，请完成以下步骤：
  1. 选择一个或多个注册表项，然后选择操作栏中的“管理分配”。如有需要，可以使用搜索框或标记列表快速查找一个或多个注册表项。
注意：
要管理多个注册表项的分配，请查看注册表项列表，然后单击“下一步”。
  1. 选择分配目标（用户和组）以分配注册表项。
    • 要添加新目标，请单击“添加新目标”。有关详细信息，请参阅添加分配目标。
    • 配置目标以指定要使用的筛选器。有关添加筛选器的信息，请参阅筛选器。
  2. 完成后，单击“完成”。

克隆注册表项

注意：
不克隆分配。
要克隆注册表项，请完成以下步骤：
  1. 选择注册表项，然后在操作栏中选择“克隆”。
  2. 编辑名称和描述。
  3. 选择要克隆注册表项的配置集。
  4. 单击“克隆”以开始克隆过程。

通过 reg 文件导入注册表项

您可以将注册表文件转换为分配的注册表项。此功能有以下限制：
  • 它仅支持 HKEY_CURRENT_USER 下的注册表值。使用注册表项功能，您只能分配 HKEY_CURRENT_USER 下的注册表设置。
  • 它不支持 REG_BINARY 和 REG_MULTI_SZ types 类型的注册表值。
为避免这些限制，我们建议您通过组策略设置中的导入组策略设置将注册表文件导入到 WEM。有关详细信息，请参阅导入组策略设置。
要导入注册表项，请完成以下步骤：
  1. 在操作栏中选择导入。
  2. 浏览本地 reg 文件。
  3. 单击导入将注册表项加载到页面。
  4. 为加载的注册表项选择选项。
  5. 为加载的注册表项选择覆盖规则。
  6. 单击导入开始导入过程。

删除注册表项

要删除注册表项，请选择该注册表项，然后在操作栏中选择删除。

删除标签

要删除注册表项的标签，请完成以下步骤：
  1. 选择注册表项，然后在操作栏中选择删除标签。
  2. 单击删除开始删除过程。

环境变量

此功能允许您将环境变量添加为可分配的操作。分配后，这些环境变量将在用户环境中创建或设置。
您可以执行以下操作：
  • 添加环境变量。
  • 刷新环境变量列表。
  • 编辑环境变量。
  • 管理环境变量的分配。
  • 克隆环境变量。
  • 删除环境变量。
  • 指定代理如何处理环境变量。
添加和分配环境变量的一般工作流程如下：
  1. 在 Web 控制台中，转到相关配置集，导航到 Actions > Environment Variable，然后单击 Add environment variable。请参阅添加环境变量。
  2. 选择您添加的环境变量，然后单击操作栏中的 Manage assignments。请参阅管理环境变量的分配。
分配需要一些时间才能生效。要立即生效，请参阅使分配立即生效。

添加环境变量

要添加环境变量，请完成以下步骤：
  1. 在“环境变量”中，单击“添加环境变量”。
  2. 配置以下设置：
    • 名称。指定一个名称以帮助您识别环境变量。
    • 描述（可选）。指定有关环境变量的附加信息。
    • 启用此环境变量。启用或禁用环境变量。禁用后，即使分配给用户，代理也不会处理它。
    • 变量名称。环境变量的功能名称。
    • 变量值。环境变量的值。
    • 执行顺序。使用此选项可确定代理处理变量的顺序。代理首先处理执行顺序值为 0（零）的变量，然后是值为 1 的变量，然后是值为 2 的变量，依此类推。发生冲突时，最后处理的变量会覆盖之前处理的变量。
  3. 完成后，单击“完成”以保存并退出。

编辑环境变量

要编辑环境变量，请完成以下步骤：
  1. 在“环境变量”中，选择环境变量。如果需要，可以使用搜索框快速查找环境变量。
  2. 在操作栏中单击“编辑”。
  3. 根据需要进行更改。
  4. 完成后，单击“保存”。

管理环境变量的分配

要管理环境变量的分配，请完成以下步骤：
  1. 选择环境变量，然后在操作栏中选择 管理分配。
  2. 选择分配目标（用户和组）以分配环境变量。
    • 要添加新目标，请单击 添加新目标。有关详细信息，请参阅添加分配目标。
    • 配置目标以指定要使用的筛选器。有关添加筛选器的信息，请参阅筛选器。
  3. 完成后，单击 完成。

克隆环境变量

注意：
  • 分配不会被克隆。
要克隆环境变量，请完成以下步骤：
  1. 选择环境变量，然后在操作栏中选择 克隆。
  2. 编辑名称和描述。
  3. 选择要将环境变量克隆到的配置集。
  4. 单击 克隆 以开始克隆过程。

删除环境变量

要删除环境变量，请选择它，然后在操作栏中选择 删除。
注意：
  • 如果环境变量已分配给用户，则删除它会影响这些用户。

指定代理如何处理环境变量

处理选项：
  • 在登录和刷新时处理环境变量
  • 在重新连接时处理环境变量
  • 取消分配时从桌面删除环境变量
  • 强制处理环境变量的筛选器
  • 强制处理环境变量的筛选器

更多信息

使分配立即生效

通常，分配会在您在高级设置中为 SQL 设置刷新延迟指定的时间段后生效。要使分配立即生效，请完成以下步骤：
  1. 转到 Web 控制台 > 监视 > 管理 > 代理 > 统计信息，然后选择代理。
  2. 在操作栏中单击更多，然后选择代理 > 刷新代理主机设置。
重要提示：

备份组策略设置

要备份组策略设置，请在域控制器上完成以下步骤：
  1. 打开组策略管理控制台。
  2. 在“组策略管理”窗口中，右键单击要备份的 GPO，然后选择“备份”。
  3. 在“备份组策略对象”窗口中，指定要保存备份的位置。您可以选择为备份添加描述。
  4. 单击“备份”开始备份，然后单击“确定”。
  5. 导航到备份文件夹，然后将其压缩为 zip 文件。
注意：
WEM 支持导入包含多个 GPO 备份文件夹的 zip 文件。

使用 WEM GPO 配置 FSLogix 配置文件容器

有关如何使用组策略管理模板配置 Windows 设置的示例，请参阅 使用 WEM GPO 配置 FSLogix Profile Container。

应用程序启动器

应用程序启动器聚合了您通过管理控制台分配给用户的所有应用程序。用户可以使用该工具在一个位置启动所有已分配的应用程序。
提示：
建议您将此工具发布为 Citrix 虚拟应用程序。
此功能提供以下优势：
  • 分配的应用程序可以更快地启动。
  • 用户可以在一个位置启动分配给他们的所有应用程序。
  • 用户可以快速访问他们收藏的网站。通过配置文件管理，浏览器书签可以漫游。
您的用户可以在其环境中直接打开应用程序启动器工具 (AppLauncherUtil.exe)。该工具位于代理安装文件夹中：%ProgramFiles%\Citrix\Workspace Environment Management Agent\ AppLauncherUtil.exe。打开该工具后，用户会看到以下内容，其中反映了分配给他们的应用程序：
应用程序启动器
  • 所有应用程序。显示所有已分配的应用程序。可用排序选项：最新、A-Z 和 Z-A。
  • 收藏夹。显示标记为收藏的应用程序。
  • 管理工具。显示以下两个工具：
    • Taskmgr。打开任务管理器。
    • VUEMUIAgent。启动 WEM UI 代理。
  • 浏览器书签。显示保存在浏览器书签中的网站。通过单击书签，用户可以快速打开浏览器并访问目标网站。书签可以按浏览器分组。此功能仅支持 Google Chrome 和 Microsoft Edge。可用排序选项：最新、A-Z 和 Z-A。
  • 省略号图标。有一个注销选项，允许用户注销其会话。
确保代理计算机上存在已分配的应用程序。如果代理计算机上未安装已分配的应用程序，则会显示该应用程序，但无法启动。
代理计算机上不存在已分配的应用程序
有关如何使用此功能的示例，请参阅在一个位置聚合已分配的应用程序。

外部任务示例

对于脚本（例如 PowerShell 脚本）：
  • 如果文件夹路径和脚本名称都不包含空格：
    • 在“路径”字段中，键入以下内容：C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe。
    • 在“参数”字段中，键入以下内容：C:\<folder path>\<script name>.ps1。
    另外，您也可以直接在“路径”字段中键入脚本文件的路径。例如：C:\<folder path>\<script name>.ps1。在“参数”字段中，根据需要指定参数。但是，脚本文件是运行还是使用其他程序打开，取决于用户环境中配置的文件类型关联。有关文件类型关联的信息，请参阅文件关联。
  • 如果文件夹路径或脚本名称包含空格：
    • 在“路径”字段中，键入以下内容：C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe。
    • 在“参数”字段中，键入以下内容：-file C:\<folder path>\<script name>.ps1。
对于应用程序（例如 iexplore.exe）：
  • 在“路径”字段中，键入以下内容：C:\Program Files\"Internet Explorer"\iexplore.exe。
  • 在“参数”字段中，键入要打开的网站的 URL：https://docs.citrix.com/。

文件系统操作

控制将文件夹和文件复制到用户环境。
提示：
您可以使用 动态令牌 来扩展 Workspace Environment Management 操作，使其功能更强大。

文件系统操作列表

现有文件和文件夹操作的列表。您可以使用“查找”根据文本字符串按名称或 ID 筛选列表。

添加文件系统操作

  1. 使用上下文菜单中的“添加”命令。
  2. 在“新建文件系统操作”对话框选项卡中输入详细信息，然后单击“确定”。

字段和控件

名称。文件或文件夹操作的显示名称，如列表中所示。
描述。允许您指定有关资源的附加信息。此字段仅在编辑或创建向导中显示。
文件系统操作状态。控制文件系统操作是启用还是禁用。禁用时，即使已分配给用户，代理也不会处理它。
源路径。要复制的源文件或文件夹的路径。
目标路径。要复制的源文件或文件夹的目标路径。
如果目标存在则覆盖。控制文件或文件夹操作是否覆盖目标位置中具有相同名称的现有文件或文件夹。如果未选中此选项，并且目标位置已存在同名文件或文件夹，则不会复制受影响的文件。
运行一次。默认情况下，Workspace Environment Management 会在代理每次刷新时运行文件系统操作。选择此选项可让 Workspace Environment Management 仅运行一次操作，而不是在每次刷新时都运行。这会加快代理刷新过程，尤其是在为用户分配了许多文件系统操作时。
操作类型。描述此文件或文件夹操作的类型：复制、删除、移动、重命名或符号链接操作。对于符号链接创建，您需要为 Windows 用户授予 SeCreateSymbolicLinkPrivilege 权限以允许创建符号链接。
执行顺序。确定操作的运行顺序，允许某些操作在其他操作之前运行。执行顺序值为 0（零）的操作首先运行，然后是值为 1 的操作，然后是值为 2 的操作，依此类推。

文件类型关联

重要提示：
您配置的文件类型关联 (FTA) 会自动成为默认关联。但是，当您打开适用的文件时，可能仍会显示“您希望如何打开此文件？”窗口，提示您选择一个应用程序来打开该文件。单击“确定”关闭该窗口。如果您不想再次看到类似的窗口，请执行以下操作：打开组策略编辑器并启用“不显示‘已安装新应用程序’通知”策略（计算机配置 > 管理模板 > Windows 组件 > 文件资源管理器）。
控制用户环境中 FTA 的创建。
提示：
您可以使用动态令牌 来扩展 Workspace Environment Management 操作，使其功能更强大。
此功能允许您将 FTA 添加为可分配的操作。
您可以执行以下操作：
  • 添加 FTA
  • 刷新 FTA
  • 编辑 FTA
  • 管理分配
  • 克隆 FTA
  • 删除 FTA

添加 FTA

  1. 使用上下文菜单中的“添加关联”命令。
  2. 在“添加文件类型关联”对话框中输入详细信息。
操作类型。描述此资源的操作类型。
名称。文件关联的显示名称，显示在文件关联列表中。
描述。此字段仅在编辑/创建向导中显示，允许您指定有关资源的附加信息。
文件关联状态。切换文件关联是“已启用”还是“已禁用”。禁用时，即使已分配给用户，代理也不会处理它。
文件扩展名。此文件类型关联使用的扩展名。如果从列表中选择文件扩展名，则 ProgID 字段会自动填充（如果文件类型存在于运行管理控制台的计算机上）。您也可以直接键入扩展名。但是，对于浏览器关联，您必须直接键入扩展名。有关详细信息，请参阅浏览器关联。
ProgID。与应用程序 (COM) 关联的程序标识符。当您从列表中选择文件扩展名时，此值会自动填充。您也可以直接键入 ProgID。要发现已安装应用程序的 ProgID，可以使用 OLE/COM 对象查看器 (oleview.exe)，并在“对象类/Ole 1.0 对象”中查找。有关 ProgID 的详细信息，请参阅程序标识符 (ProgID)。
操作。允许您选择操作类型：打开、编辑或打印。
目标应用程序。允许您指定与此文件扩展名一起使用的可执行文件。键入可执行文件的完整路径。例如，对于 UltraEdit 文本编辑器：C:\Program Files\IDM Computer Solutions\UltraEdit\uedit64.exe
命令。允许您指定要与可执行文件关联的操作类型。例如：
  • 对于打开操作，键入 “%1”。
  • 对于打印操作，键入 /p"%1"。
设置为默认操作。切换此关联是否设置为该文件扩展名的默认值。
覆盖。切换此文件关联是否覆盖指定扩展名的任何现有关联。
运行一次。默认情况下，Workspace Environment Management (WEM) 会在代理每次刷新时创建文件关联。选择此选项可一次性创建文件关联，而不是在每次刷新时都创建。这会加快代理刷新过程，特别是当您为用户分配了许多文件关联时。
提示：
您可以使用 文件类型关联助手 数据，将其添加为管理控制台中的可分配操作。
有关详细信息，请参阅 须知。

编辑文件类型关联

要编辑文件类型关联，请完成以下步骤：
  1. 在文件类型关联中，选择所需的关联。如果需要，可以使用搜索框快速查找所需的文件类型关联。
  2. 在操作栏中单击编辑。
  3. 根据需要进行更改。
  4. 完成后，单击保存。

管理分配

要管理文件类型关联的分配，请完成以下步骤：
  1. 选择文件类型关联，然后在操作栏中选择管理分配。
  2. 选择分配目标（用户和组）以分配关联。
  • 要添加新目标，请单击添加新目标。有关详细信息，请参阅 添加分配目标。
  • 使用筛选器使分配情境化。如有必要，为每个目标设置所需关联的优先级。
  • 单击与分配关联的三个省略号以复制配置。
  • 您还可以通过选择与分配关联的相应选项，将复制的配置应用于所有目标。

克隆文件类型关联

要克隆文件类型关联，请完成以下步骤：
  1. 选择文件类型关联，然后在操作栏中选择 克隆。
  2. 编辑名称和描述。
  3. 选择要将文件类型关联克隆到的配置集。
  4. 单击 克隆 以开始克隆过程。

删除文件类型关联

要删除文件类型关联，请选择它，然后在操作栏中选择 删除。

指定代理如何处理文件类型关联

处理选项：
  • 在登录和刷新时处理文件类型关联
  • 在重新连接时处理 FTA
  • 强制处理 FTA 的筛选器
  • 取消分配时从桌面删除 FTA

JSON 文件

此功能允许您添加 JSON 对象并将其分配以创建或修改 JSON 文件。使用此功能，您可以将个性化设置应用于具有 JSON 配置文件的应用程序（例如 Microsoft Teams）。
您可以执行以下操作：
  • 添加 JSON 对象。
  • 刷新 JSON 对象列表。
  • 将 JSON 对象添加到 Windows 11“开始”菜单布局
  • 编辑 JSON 对象。
  • 管理 JSON 对象的分配。
  • 克隆 JSON 对象。
  • 删除 JSON 对象。
  • 控制是否处理 JSON 对象。
添加和分配 JSON 对象的常规工作流程如下：
  1. 在 Web 控制台中，转到相关配置集，导航到 Actions > JSON object，然后单击 Add JSON object。请参阅添加 JSON 对象。
  2. 选择您添加的 JSON 对象，然后单击操作栏中的 Manage assignments。请参阅管理 JSON 对象的分配。
分配需要一些时间才能生效。要立即生效，请参阅使分配立即生效。

添加 JSON 对象

要添加 JSON 对象，请完成以下步骤：
  1. 在 JSON 对象中，单击 添加 JSON 对象。
  2. 配置以下设置：
    • 名称。指定一个名称以帮助您识别 JSON 对象。
    • 描述（可选）。指定有关 JSON 对象的其他信息。
    • 启用此操作。启用或禁用 JSON 对象。禁用时，即使将其分配给用户或计算机，代理也不会处理它。
    • 文件路径和内容。指定要对象修改的 JSON 文件的路径。指定的内容将与目标文件中的现有内容合并。要了解内容如何合并，请参阅JSON 内容合并示例。
    如果您不想手动输入路径和内容，请单击 使用模板生成。使用模板生成功能允许您使用模板生成 JSON 内容，以配置特定应用程序。目前，此功能仅适用于 Microsoft Teams。
    使用模板生成
    • 如果文件不存在则创建。这是一个故障保护选项，可确保对象按预期工作。例如，对于 Microsoft Teams，在首次启动 Microsoft Teams 之前，“desktop-config.json”文件不存在。
    • 备份原始文件。选中后，代理会自动在同一位置保存目标文件的备份。备份继承原始文件的名称，并带有后缀“-WEMCopy。”
    • 处理模式
      • 用户级处理。在用户登录或代理刷新时处理此操作。
      • 计算机级处理。在计算机启动或代理刷新其 SQL 连接设置时处理此操作。
    • 运行一次。如果选中，WEM 将仅运行此操作一次。
  3. 完成时，单击 完成 以保存并退出。

JSON 内容合并示例

以下示例说明了指定内容如何与目标 JSON 文件中的现有内容合并。
目标文件中的内容示例：
{
    "value": "value1",
    "array": ["test1", "test2"],
    "object": {"key1": "value1", "key2":  "value2"}
}
指定内容的示例：
{
    "value": "value2",
    "array": ["test2", "test3"],
    "object": { "key1": "changed", "key3": "value3", "key4": "value4" },
    "new": 1
}
合并结果示例：
{
    "value": "value2",
    "array": ["test1", "test2", "test3"],
    "object": {"key1": "changed", "key2": "value2", "key3": "value3", "key4": "value4" },
     "new": 1
}

将 JSON 对象添加到 Windows 11“开始”菜单布局

要将 JSON 对象添加到 Windows 11“开始”菜单布局，请完成以下步骤。
  1. 单击 添加新 JSON 对象。
  2. 选择 Windows 11 的“开始”菜单配置。
  3. 在 添加 JSON 对象 页面中粘贴配置。
  4. 点击 完成。
有关详细信息，请参阅自定义 Windows 11 的“开始”菜单布局。

编辑 JSON 对象

要编辑 JSON 对象，请完成以下步骤：
  1. 在 JSON 对象 中，选择 JSON 对象。如果需要，可以使用搜索框快速查找 JSON 对象。
  2. 在操作栏中单击“编辑”。
  3. 根据需要进行更改。
  4. 完成后，单击“保存”。

管理 JSON 对象的分配

要管理 JSON 对象的分配，请完成以下步骤：
  1. 选择 JSON 对象，然后在操作栏中选择“管理分配”。
  2. 选择要分配 JSON 对象的目标（用户和组）。
    • 要添加新目标，请单击“添加新目标”。有关详细信息，请参阅添加分配目标。
    • 配置目标以指定要使用的筛选器。有关添加筛选器的信息，请参阅筛选器。
  3. 完成后，单击“完成”。

克隆 JSON 对象

注意：
  • 不克隆分配。
要克隆 JSON 对象，请完成以下步骤：
  1. 选择 JSON 对象，然后在操作栏中选择“克隆”。
  2. 编辑名称和描述。
  3. 选择要将 JSON 对象克隆到的配置集。
  4. 单击“克隆”以开始克隆过程。

删除 JSON 对象

要删除 JSON 对象，请选择它，然后在操作栏中选择“删除”。
注意：
  • 如果 JSON 对象已分配给用户，则删除它会影响这些用户。

INI 文件

控制 .ini 文件操作的创建，允许您修改 .ini 文件。

Ini 文件操作列表

现有 .ini 文件操作的列表。您可以使用“查找”根据文本字符串按名称或 ID 筛选列表。

添加 INI 文件操作

  1. 使用上下文菜单“添加”命令。
  2. 在“添加 INI 文件操作”页面中输入详细信息，然后单击“确定”。

字段和控件

名称。 .ini 文件操作的显示名称，如“Ini 文件操作”列表中所示。
描述。此字段仅在编辑/创建向导中显示，允许您指定有关资源的附加信息。
ini 文件操作状态。切换 .ini 文件操作是启用还是禁用。禁用时，即使已分配给用户，代理也不会处理它。
目标路径。指定 .ini 文件的位置，该文件将在用户环境中解析时进行修改。
注意：
使用非域加入代理时，如果目标路径是网络共享，WEM 可能无法工作。
目标节。指定此操作所针对的 .ini 文件中的哪个节。如果指定不存在的节，则会创建该节。
目标值名称。指定要添加的值的名称。
目标值。指定值本身。
运行一次。默认情况下，Workspace Environment Management 会在代理每次刷新时执行 .ini 文件操作。选中此复选框可使 Workspace Environment Management 仅运行一次，而不是在每次刷新时运行。此操作可加快代理刷新过程，尤其是在为用户分配了许多 .ini 文件操作时。
操作类型。描述此资源的操作类型。

编辑 INI 文件操作

要编辑，请完成以下步骤：
  1. 在操作栏中单击编辑。
  2. 根据需要进行更改。
  3. 完成后，单击保存。

管理分配

要管理分配，请完成以下步骤：
  1. 选择 INI 文件，然后在操作栏中选择管理分配。
  2. 选择分配目标（用户和组）以分配此 INI 文件。
  3. 使用筛选器根据上下文调整分配。
  4. 为每个目标设置所选 INI 文件的优先级。
  5. 完成后，单击保存。

克隆 INI 文件操作

要克隆，请完成以下步骤：
  1. 选择 INI 文件，然后在操作栏中选择克隆。
  2. 编辑名称和描述。
  3. 选择您需要克隆的配置集。
  4. 单击克隆以开始克隆过程。

删除 INI 文件

要删除 INI 文件，请选择它，然后在操作栏中选择删除。

端口

允许您添加端口映射作为可分配的操作。端口功能允许客户端 COM 端口映射。您还可以使用 Citrix Studio 策略来启用 COM 端口的自动连接。 如果您使用端口功能手动控制每个端口的映射，请记住在 Citrix Studio 中启用客户端 COM 端口重定向策略。默认情况下，禁止 COM 端口重定向。

端口列表

现有端口的列表。您可以使用“查找”按名称或 ID 筛选列表。

添加端口

  1. 从上下文菜单中选择“添加端口映射”。
  2. 在“添加端口映射”对话框选项卡上输入详细信息，然后单击“确定”。

字段和控件

名称。端口的显示名称，与端口列表中显示的名称相同。
描述。仅在编辑/创建向导中显示，允许您指定有关资源的附加信息。
端口状态。切换端口是启用还是禁用。禁用时，即使已分配给用户，代理也不会处理该端口。
端口名称。端口的功能名称。
端口目标。目标端口。

选项卡

操作类型。描述此资源执行的操作类型。
例如，您可以按如下方式配置端口设置：
  • 端口名称：选择“COM3:”
  • 端口目标：输入 \\Client\COM3::

编辑端口映射

要编辑端口映射，请完成以下步骤：
  1. 在操作栏中单击“编辑”。
  2. 根据需要进行更改。
  3. 完成后，单击“保存”。

管理分配

要管理分配，请完成以下步骤：
  1. 选择一个端口映射，然后在操作栏中选择“管理分配”。
  2. 选择分配目标（用户和组），以将此端口分配给它们。
  3. 使用筛选器为分配提供上下文。
  4. 为每个目标设置所选端口映射的优先级。
  5. 完成后，单击“保存”。

克隆端口映射

要克隆，请完成以下步骤：
  1. 选择端口，然后在操作栏中选择克隆。
  2. 编辑名称和描述。
  3. 选择您需要克隆的配置集。
  4. 单击克隆以开始克隆过程。

删除端口映射

要删除端口映射，请选择它，然后在操作栏中选择删除。

用户 DSN

控制用户 DSN 的创建。

用户 DSN 列表

现有用户 DSN 的列表。您可以使用查找根据文本字符串按名称或 ID 筛选列表。

添加用户 DSN

  1. 使用上下文菜单添加命令。
  2. 在添加用户 DSN 对话框选项卡中输入详细信息，然后单击确定。

字段和控件

名称。用户 DSN 的显示名称，如用户 DSN 列表中所示。
描述。此字段仅在编辑/创建向导中显示，允许您指定有关资源的附加信息。
用户 DSN 状态。切换用户 DSN 是启用还是禁用。禁用时，即使已分配给用户，代理也不会对其进行处理。
数据源名称。用户 DSN 的功能名称。
驱动程序。DSN 驱动程序。目前，仅支持 SQL Server DSN。
服务器名称。用户 DSN 连接到的 SQL Server 的名称。
数据库名称。用户 DSN 连接到的 SQL 数据库的名称。
运行一次。默认情况下，Workspace Environment Management 会在代理每次刷新时创建一个用户 DSN。勾选此框可使 Workspace Environment Management 仅创建一次用户 DSN，而不是在每次刷新时都创建。这会加快代理刷新过程，尤其是当您为用户分配了许多 DSN 时。
操作类型。描述此资源的操作类型。

编辑用户 DSN

要编辑用户 DSN，请完成以下步骤：
  1. 在操作栏中单击“编辑”。
  2. 根据需要进行更改。
  3. 完成后，单击“保存”。

管理用户 DSN 的分配

要管理用户 DSN 的分配，请完成以下步骤：
  1. 选择用户 DSN，然后在操作栏中选择管理分配。
  2. 选择分配目标（用户、组和 OU），以分配用户 DSN。
  3. 使用筛选器以根据上下文调整分配。
  4. 设置所选用户 DSN 针对每个目标的优先级。
  5. 完成后，单击保存。

克隆用户 DSN

要克隆用户 DSN，请完成以下步骤：
  1. 选择用户 DSN，然后在操作栏中选择克隆。
  2. 编辑名称和描述。
  3. 选择您需要克隆的配置集。
  4. 单击克隆以开始克隆过程。

删除用户 DSN

要删除用户 DSN，请选择它，然后在操作栏中选择删除。