脚本化任务

Last published : Nov 13, 2026
提示：
脚本化任务在计算机级别运行。要在用户会话级别运行任务，请改用外部任务。
此页面允许您配置和自动化脚本化任务，以满足您的环境管理需求。
Related information
配置集

创建脚本化任务

脚本分为两种类型：内置脚本和自定义脚本。每种类型都提供两种查看模式：脚本视图和任务视图。所有脚本化任务都在配置集级别执行。
要从脚本创建任务，请按照以下步骤操作：
  1. 在脚本化任务页面上，选择脚本视图，找到特定脚本，然后单击创建任务 (+) 图标。
  2. 在创建任务向导中，配置以下设置：
  3. 点击 完成。
注意：
创建脚本化任务后，您可以直接从脚本列表中管理它。展开脚本以显示其任务，然后将鼠标悬停在任务行上以访问查看、编辑和删除操作图标。

通用

在常规页面上配置以下设置：
  • 启用此任务。选择是为当前配置集启用（是）还是禁用（否）任务。如果禁用，代理不会处理该任务。
  • 验证签名。选择是否在运行任务之前验证签名。当脚本化任务被授予完全访问权限时，签名验证是强制性的。
  • 任务超时。选择是否为任务设置超时（以分钟为单位）。当超时发生时，任务将被强制终止。支持的值：1–60。我们建议为任务设置超时。否则，任务可能会一直运行，从而阻止其他任务运行。
  • 筛选器。选择是否通过选择筛选器来使任务情境化。选择筛选器后，此任务仅在满足筛选器中的所有条件时运行。选择筛选器时，请考虑以下事项：
    • 如果筛选器包含不适用于脚本化任务的条件，则代理在运行任务之前评估筛选器时会跳过这些条件。有关不适用于脚本化任务的条件的完整列表，请参阅不适用于计算机设置的条件。

触发器

在“触发器”页面上配置以下设置：
  • 为任务配置触发器。您可以执行以下操作：
    • 选择要与任务关联的触发器。激活后，这些触发器会在用户环境中启动任务。
    • 选择是否仅显示适用于此任务的触发器。
    • 创建新触发器。请参阅创建触发器。
    注意：
    要编辑现有触发器，请转到触发器。

参数

在“参数”页面上配置以下设置：
  • 将参数传递给脚本化任务。选择是否将参数传递给脚本化任务。启用后，您可以在运行时将输入作为参数变量提供给脚本化任务。这样做的好处是，您可以在不更改底层代码的情况下控制脚本化任务的行为方式。以下参数类型可用：
    • 整数。示例：123。
    • 字符串。示例：hello world。
    • 布尔值。真或假。
    • 字符。示例：c。
    • 开关。真或假。
    • 双精度浮点数。示例：1.023。
    • 日期和时间。示例：YYYY-MM-DD HH:mm:ss。
    • 文件路径。输入要传递给 System.IO.FileInfo 类的路径。支持环境变量。路径不得包含以下字符：* ? < >。
    注意：
    • 您最多可以配置 20 个参数。
    • 除了“开关”类型的参数外，名称字段是可选的。
    • PowerShell 支持部分参数名称。使用部分参数名称时，请确保该名称是唯一的 — 将其与现有参数名称区分开来。示例：以下参数名称对于 PowerShell 而言是相同的：-t、-ti 和 -title。在这种情况下，请提供足够的参数名称字母以将其与其他参数区分开来。

输出

在“输出”页面上配置以下设置：
  • 输出文件。 选择是否要收集任务输出的文件。如果选中，则在为任务生成的报告中包含输出文件内容。然后，您可以在报告中查看输出文件内容，而无需访问用户环境中的输出文件。
  • 输出高亮显示。 选择是否要在输出文件内容和控制台输出中高亮显示某些内容。
    • 高亮显示关键字。 指定您希望报告高亮显示的关键字。您可以输入多个关键字，用逗号分隔。输入关键字后，按 Enter 键继续。如果指定，报告中与您的关键字匹配的内容将在生成的报告的“输出文件内容”和“控制台输出”部分中高亮显示。
    • 高亮显示正则表达式匹配项。 输入描述要高亮显示内容的正则表达式。正则表达式必须符合 .NET 正则表达式库语法，该语法与 PCRE 兼容。有关详细信息，请参阅 Microsoft 文档：<https://docs.microsoft.com/zh-cn/dotnet/standard/base-types/regular-expression-language-quick-reference>。
      • 正则表达式。 输入一个正则表达式，描述您要突出显示的内容。
      • 忽略大小写。选择内容是否必须精确匹配大小写。
      • 使用多行匹配。选择是否使用多行匹配，其中 \^ 和 \$ 匹配每行的开头和结尾，而不是整个输出内容的开头和结尾。
      • 仅捕获命名组。选择是否仅捕获命名组。捕获组通过在正则表达式模式中使用括号定义。命名组通过 (?<name> subexpression) 语法显式分配名称或编号。
      • 作为上下文线索包含的行数。指定要在突出显示中作为上下文线索包含的匹配项之前和之后的行数。支持的值：1–10。
      • 报告中仅包含正则表达式匹配项。控制是在报告中包含整个输出内容，还是仅包含与正则表达式匹配的内容。启用此选项可减少传输到 Citrix Cloud 的数据量。启用此选项后，无论指定的关键字是什么，突出显示关键字功能都不会显示任何内容。
  • 高级选项。
    • 即使发生运行时错误也收集输出。控制即使在运行任务时发生错误，是否也收集输出文件内容和控制台输出。

查看脚本化任务的报告

  1. 在“脚本化任务”页面上，单击脚本行中的任务下拉菜单以展开其任务列表。
  2. 将鼠标悬停在任务上以显示操作图标。
  3. 单击“查看报告”图标。
结果，您将转到“监视 > 报告”页面，您可以在其中查看与任务相关的报告（如果有）。单击省略号以查看更详细的信息。有关详细信息，请参阅报告。
注意：
要运行设置为“以登录用户身份运行”的脚本化任务，请在“监视 > 管理 > 代理”中选择最近连接的代理，然后选择“更多 > 运行脚本化任务”。