Workspace Environment Management

外部任务

控制外部任务的执行。外部任务包括运行脚本和应用程序,只要代理主机具有运行脚本和应用程序的相应程序。常用脚本包括: .vbs.cmd 脚本。

使用外部任务功能,您可以指定何时运行外部任务。这样可以让您更有效地管理用户环境。

提示:

您可以使用动态令牌来扩展 Workspace Environment Management 操作,使其功能更强大。

外部任务列表

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

添加外部任务

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

字段和控件

添加外部任务

名称。用于指定外部任务的显示名称,该名称显示在外部任务列表中。

说明。用于指定有关外部任务的其他信息。

路径。用于指定外部任务的路径。该路径在用户环境中进行解析。请确保:

  • 您在此处指定的路径与代理主机一致。
  • 代理主机具有运行任务的相应程序。

争论。用于指定启动参数或参数。您可以键入字符串。字符串包含要传递给目标脚本或应用程序的参数。有关使用“路径”和“参数”字段的示例,请参阅 外部任务示例

外部任务状态。控制外部任务是启用还是禁用。禁用后,即使将任务分配给用户,代理也不会处理任务。

运行隐藏。如果选中此选项,则任务将在后台运行,而不会向用户显示。

运行一次。如果选中此选项,无论您在触发器选项卡上选择了哪个选项,也不管代理是否重新启动,WEM 都只会运行一次任务。默认选择此选项。

执行顺序。允许您指定每个任务的运行顺序。当您向用户分配了多个任务并且其中一些任务需要其他任务才能成功运行时,此选项会很有用。默认情况下,该值为 0。首先运行执行顺序值为 0(零)的任务,然后运行值为 1 的任务,然后运行值为 2 的任务,依此类推。

等待任务完成。用于指定代理等待任务完成的时间。默认情况下, 等待超时 值为 30 秒。

操作类型。描述外部任务是什么类型的操作。

外部任务触发器

用户会话触发器。此功能允许您将以下会话活动配置为外部任务的触发器:

  • 刷新。控制用户刷新代理时是否运行外部任务。默认情况下,选项处于选中状态。

  • 重新连接。控制用户重新连接到运行代理的计算机时是否运行外部任务。默认情况下,选项处于选中状态。如果 WEM 代理安装在物理 Windows 设备上,则此选项不适用。

  • 登录。控制用户登录时是否运行外部任务。默认情况下,选项处于选中状态。

  • 注销。控制用户注销时是否运行外部任务。除非 Citrix 用户登录服务正在运行,否则此选项不起作用。默认情况下,未选中该选项。

  • 断开连接。控制当用户与正在运行代理的计算机断开连接时是否运行外部任务。默认情况下,未选中该选项。

  • 锁定。控制当用户锁定正在运行代理的计算机时是否运行外部任务。默认情况下,未选中该选项。

  • 取消锁定。控制当用户解锁正在运行代理的计算机时是否运行外部任务。默认情况下,未选中该选项。

使用断开连接、锁定和解锁选项时,请考虑以下限制:

  • 这些选项的实现基于 Windows 事件。在某些环境中,这些选项可能无法按预期工作。例如,在 Windows 10 或 Windows 11 单会话 VDA 上运行的桌面中,断开连接选项不起作用。相反,请使用锁定选项。(在这种情况下,我们收到的操作是“锁定”。)

  • 我们建议您将这些选项用于 UI 代理。有两个原因:

    • 当您对 CMD 代理使用这些选项时,代理会在每次发生相应事件时在用户环境中启动,以检查外部任务是否正在运行。
    • 在并发任务方案中,CMD 代理可能无法以最佳方式工作。

用户进程触发器。此功能允许您将用户进程配置为外部任务的触发器。使用此功能,您可以定义外部任务,以便仅在某些进程运行时才提供资源,并在进程结束时撤消这些资源。与登录或注销时处理外部任务相比,使用进程作为外部任务的触发器可以更精确地管理用户环境。

  • 在使用此功能之前,请验证是否满足以下先决条件:

    • WEM 代理将在 UI 模式下启动和运行。
    • 指定的进程与登录用户在同一用户会话中运行。
    • 要使配置的外部任务保持最新状态,请务必在“高级 设置”>“配置”>“高级选项”选项卡上选 择“启用自动刷新”。
  • 在进程启动时运行。控制在指定进程启动时是否运行外部任务。

  • 进程结束时运行。控制是否在指定进程结束时运行外部任务。

故障排除

启用该功能后,WEM Agent 将在用户首次注销时创建一个名为 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
    • 参数字段中,键入以下内容:-file C:\<folder path>\<script name>.ps1

对于应用程序(例如 iexplore.exe):

  • 在“路径”字段中,键入以下内容: C:\Program Files\"Internet Explorer"\iexplore.exe
  • 在“参数”字段中,键入要打开的网站的 URL: https://docs.citrix.com/
外部任务