脚本化任务设置

Last published : Nov 13, 2026
列出“脚本化任务”页面上所有可用的脚本化任务。脚本化任务在配置集级别运行。在此处,您可以配置为当前配置集启用哪些脚本化任务。要编辑脚本化任务,请转到脚本化任务。

配置脚本化任务

  1. 在“脚本化任务设置”页面上,找到脚本化任务,选择省略号,然后选择“配置”。
  2. 在“配置脚本化任务”向导中,配置以下设置,然后单击“保存”。
在“常规”中:
  • 启用此任务。选择是为当前配置集启用(是)还是禁用(否)此任务。如果禁用,代理将不处理该任务。
  • 验证签名。选择是否在运行任务之前验证签名。当脚本化任务被授予完全访问权限时,签名验证是强制性的。
  • 任务超时。选择是否为任务设置超时(以分钟为单位)。超时发生时,任务将被强制终止。支持的值:1–60。我们建议为任务设置超时。否则,任务可能会一直运行,从而阻止其他任务运行。
  • 筛选器。选择是否通过选择筛选器来情境化任务。选中筛选器后,此任务仅在满足筛选器中的所有条件时运行。选择筛选器时,请考虑以下事项:
    • 如果筛选器包含不适用于脚本化任务的条件,则代理在运行任务之前评估筛选器时会跳过这些条件。有关不适用于脚本化任务的条件的完整列表,请参阅不适用于计算机设置的条件。
在“触发器”中:
  • 配置任务的触发器。您可以执行以下操作:
    • 选择要与任务关联的触发器。激活后,这些触发器将在用户环境中启动任务。
    • 选择是否仅显示适用于此任务的触发器。
    • 创建新触发器。请参阅创建触发器。
    注意:
    要编辑现有触发器,请转至触发器。
在参数中:
  • 将参数传递给脚本化任务。选择是否将参数传递给脚本化任务。启用后,您可以在运行时将输入作为参数变量提供给脚本化任务。这样做的好处是,您可以在不更改底层代码的情况下控制脚本化任务的行为。以下参数类型可用:
    • 整数。示例:123。
    • 字符串。示例:hello world。
    • 布尔值。True 或 False。
    • 字符。示例:c。
    • 开关。True 或 False。
    • 双精度浮点数。示例: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 的数据量。启用此选项后,“突出显示关键字”功能将不显示任何内容,无论指定的关键字是什么。
  • 高级选项。
    • 即使发生运行时错误也收集输出。 控制即使在运行任务时发生错误,是否也收集输出文件内容和控制台输出。

查看脚本化任务的报告

在 脚本化任务设置 页面上,找到脚本化任务,选择省略号,然后选择 查看报告。结果,您将转到 监视 > 报告 页面,您可以在其中查看与任务相关的报告(如果有)。单击省略号可查看更详细的信息。有关详细信息,请参阅 报告。