TaskSettings 对象
一个脚本对象,提供任务计划程序服务用于执行任务的设置。
成员
TaskSettings 对象具有以下类型的成员:
属性
TaskSettings 对象具有这些属性。
属性 | 访问类型 | 说明 |
---|---|---|
AllowDemandStart |
读取/写入 |
获取或设置一个布尔值,该值指示可以使用“运行”命令或上下文菜单启动任务。 |
AllowHardTerminate |
读取/写入 |
获取或设置一个布尔值,该值指示可以使用 TerminateProcess 终止任务。 |
兼容性 |
读取/写入 |
获取或设置一个整数值,该值指示任务与哪个版本的任务计划程序兼容。 |
DeleteExpiredTaskAfter |
读取/写入 |
获取或设置任务计划程序在过期后删除任务之前等待的时间量。 |
DisallowStartIfOnBatteries |
读取/写入 |
获取或设置一个布尔值,该值指示如果计算机使用电池供电,则不会启动任务。 |
已启用 |
读取/写入 |
获取或设置一个布尔值,该值指示已启用任务。 仅当此设置为 True 时,才能执行该任务。 |
ExecutionTimeLimit |
读取/写入 |
获取或设置完成任务所允许的时间量。 |
Hidden |
读取/写入 |
获取或设置一个布尔值,该值指示任务在 UI 中不可见。 但是,管理员可以通过使用使所有任务在 UI 中可见的“主开关”来替代此设置。 |
IdleSettings |
读取/写入 |
获取或设置指定任务计划程序在计算机处于空闲状态时如何执行任务的信息。 |
MultipleInstances |
读取/写入 |
获取或设置策略,该策略定义任务计划程序如何处理任务的多个实例。 |
NetworkSettings |
读取/写入 |
获取或设置包含网络配置文件标识符和名称的网络设置对象。 如果 TaskSettings 的 RunOnlyIfNetworkAvailable 属性为 True,并在 NetworkSettings 属性中指定了网络属性,则仅当指定的网络配置文件可用时,任务才会运行。 |
优先 |
读取/写入 |
获取或设置任务的优先级。 |
RestartCount |
读取/写入 |
获取或设置任务计划程序尝试重启任务的次数。 |
RestartInterval |
读取/写入 |
获取或设置一个值,该值指定任务计划程序将尝试重启任务的时间长度。 |
RunOnlyIfIdle |
读取/写入 |
获取或设置一个布尔值,该值指示仅当计算机处于空闲状态时,任务计划程序才会运行任务。 |
RunOnlyIfNetworkAvailable |
读取/写入 |
获取或设置一个布尔值,该值指示任务计划程序仅在网络可用时运行任务。 |
StartWhenAvailable |
读取/写入 |
获取或设置一个布尔值,该值指示任务计划程序可以在其计划时间过后随时启动任务。 |
StopIfGoingOnBatteries |
读取/写入 |
获取或设置一个布尔值,该值指示当计算机开始使用电池供电时任务将停止。 |
WakeToRun |
读取/写入 |
获取或设置一个布尔值,该值指示任务计划程序将在运行任务时唤醒计算机。 |
XmlText |
读取/写入 |
获取或设置任务设置的 XML 格式定义。 |
备注
默认情况下,任务将在开始运行 72 小时后停止。 可以通过更改 ExecutionTimeLimit 设置来更改此设置。
读取或写入任务的 XML 时,任务设置在任务计划程序架构的 Settings 元素中定义。
示例
有关详细信息和此脚本对象的代码示例,请参阅 时间触发器示例 (脚本) 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
类型库 |
|
DLL |
|