外部任务

Last published : Nov 13, 2026
控制外部任务的执行。外部任务包括运行脚本和应用程序，只要代理主机具有运行它们的相应程序即可。常用的脚本包括：.vbs 和 .cmd 脚本。
借助外部任务功能，您可以指定何时运行外部任务。这样做可以更有效地管理用户环境。
提示：
您可以使用动态令牌来扩展 Workspace Environment Management 操作，使其功能更强大。
Related information
操作

外部任务列表

现有外部任务的列表。您可以使用“查找”来筛选该列表。

添加外部任务

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

字段和控件

添加外部任务
名称。允许您指定外部任务的显示名称，该名称将显示在外部任务列表中。
描述。允许您指定有关外部任务的其他信息。
路径。允许您指定外部任务的路径。该路径在用户环境中解析。请确保：
  • 您在此处指定的路径与代理主机一致。
  • 代理主机具有运行该任务的相应程序。
参数。允许您指定启动参数或自变量。您可以键入一个字符串。该字符串包含要传递给目标脚本或应用程序的参数。有关使用“路径”和“参数”字段的示例，请参阅外部任务示例。
外部任务状态。控制外部任务是启用还是禁用。禁用时，即使任务已分配给用户，代理也不会处理该任务。
隐藏运行。如果选中，任务将在后台运行，并且不会向用户显示。
仅运行一次。如果选中，WEM 将仅运行一次任务，无论您在“触发器”选项卡上选择哪些选项，也无论代理是否重新启动。默认情况下，此选项处于选中状态。
执行顺序。允许您指定每个任务的运行顺序。当您有多个任务分配给用户，并且其中一些任务依赖于其他任务才能成功运行时，此选项会很有用。默认情况下，值为 0。执行顺序值为 0（零）的任务首先运行，然后是值为 1 的任务，然后是值为 2 的任务，依此类推。
等待任务完成。允许您指定代理等待任务完成的时间。默认情况下，“等待超时”值为 30 秒。
操作类型。描述外部任务的操作类型。
外部任务触发器
用户会话触发器。此功能允许您将以下会话活动配置为外部任务的触发器：
  • 刷新。控制当用户刷新代理时是否运行外部任务。默认情况下，此选项处于选中状态。
  • 重新连接。控制当用户重新连接到运行代理的计算机时是否运行外部任务。默认情况下，此选项处于选中状态。如果 WEM 代理安装在物理 Windows 设备上，则此选项不适用。
  • 登录。控制当用户登录时是否运行外部任务。默认情况下，此选项处于选中状态。
  • 注销。控制当用户注销时是否运行外部任务。除非 Citrix 用户登录服务正在运行，否则此选项不起作用。默认情况下，此选项未选中。
  • 断开连接。控制当用户从运行代理的计算机断开连接时是否运行外部任务。默认情况下，此选项未选中。
  • 锁定。控制当用户锁定运行代理的计算机时是否运行外部任务。默认情况下，此选项未选中。
  • 解锁。控制当用户解锁运行代理的计算机时是否运行外部任务。默认情况下，此选项未选中。
使用断开连接、锁定和解锁选项时，请考虑以下限制：
  • 这些选项的实现基于 Windows 事件。在某些环境中，这些选项可能无法按预期工作。例如，在运行 Windows 10 或 Windows 11 单会话 VDA 的桌面中，断开连接选项不起作用。请改用锁定选项。（在这种情况下，我们收到的操作是“锁定”。）
  • 我们建议您将这些选项与 UI 代理一起使用。原因有二：
    • 当您将这些选项与 CMD 代理一起使用时，每次发生相应事件时，代理都会在用户环境中启动，以检查外部任务是否运行。
    • CMD 代理在并发任务场景中可能无法最佳运行。
用户进程触发器。此功能允许您将用户进程配置为外部任务的触发器。使用此功能，您可以定义外部任务，以便仅在某些进程运行时提供资源，并在进程结束时撤销这些资源。与在登录或注销时处理外部任务相比，使用进程作为外部任务的触发器可以更精确地管理用户环境。
  • 在使用此功能之前，请验证是否满足以下先决条件：
    • WEM 代理以 UI 模式启动和运行。
    • 指定的进程与登录用户在同一用户会话中运行。
    • 要使配置的外部任务保持最新，请务必在“高级设置 > 配置 > 高级选项”选项卡上选择“启用自动刷新”。
  • 进程启动时运行。控制在指定进程启动时是否运行外部任务。
  • 进程结束时运行。控制在指定进程结束时是否运行外部任务。

故障排除

启用此功能后，WEM 代理会在用户首次注销时创建一个名为 Citrix WEM Agent Logoff.log 的日志文件。该日志文件位于用户配置文件根文件夹中。WEM 代理会在用户每次注销时将信息写入日志文件。这些信息可帮助您监视和排查与外部任务相关的问题。

外部任务示例

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