外部任务

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

外部任务列表

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

添加外部任务

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

字段和控件

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

故障排除

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

外部任务示例

对于脚本（例如，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。
    • 在 Arguments 字段中，键入以下内容：-file C:\<folder path>\<script name>.ps1。
对于应用程序（例如，iexplore.exe）：
  • 在 Path 字段中，键入以下内容：C:\Program Files\"Internet Explorer"\iexplore.exe。
  • 在 Arguments 字段中，键入要打开的网站的 URL：https://docs.citrix.com/。