Set-ScheduledJobOption

Set-ScheduledJobOption
    [-InputObject] <ScheduledJobOptions>
    [-PassThru]
    [-RunElevated]
    [-HideInTaskScheduler]
    [-RestartOnIdleResume]
    [-MultipleInstancePolicy <TaskMultipleInstancePolicy>]
    [-DoNotAllowDemandStart]
    [-RequireNetwork]
    [-StopIfGoingOffIdle]
    [-WakeToRun]
    [-ContinueIfGoingOnBattery]
    [-StartIfOnBattery]
    [-IdleTimeout <TimeSpan>]
    [-IdleDuration <TimeSpan>]
    [-StartIfIdle]
    [<CommonParameters>]

Set-ScheduledJobOptions cmdlet 更改计划作业的作业选项。

若要更改计划作业的选项，请首先使用 Get-ScheduledJobOption cmdlet 获取计划作业的作业选项。 然后，通过管道将选项传递给 Set-ScheduledJobOption 或保存变量中的选项，并使用 Set-ScheduledJobOption cmdlet 的 InputObject 参数来标识这些选项。 使用 Set-ScheduledJobOption 的剩余参数更改作业选项。

若要打开作业选项，请使用设置该选项的参数。 若要关闭选项，请键入参数名称、冒号（:)和$False）。 例如，若要关闭 RunElevated 选项，请键入 -RunElevated:$False。

每个作业选项对象都包含一个包含计划作业的 JobDefinition 属性，因此在更改作业选项时保留与计划作业的关联。

计划作业选项确定作业在任务计划程序启动作业时如何运行。 使用 Start-Job cmdlet 启动计划作业时，这些选项不适用。

Set-ScheduledJobOption 是 WINDOWS PowerShell 中包含的 PSScheduledJob 模块中作业计划 cmdlet 的集合之一。

有关计划作业的详细信息，请参阅 PSScheduledJob 模块中的“关于”主题。 导入 PSScheduledJob 模块，然后键入：Get-Help about_Scheduled* 或查看about_Scheduled_Jobs。

此 cmdlet 已在 Windows PowerShell 3.0 中引入。

PS C:\> Get-ScheduledJobOption -Name "DeployPackage"
StartIfOnBatteries     : False
StopIfGoingOnBatteries : True
WakeToRun              : False
StartIfNotIdle         : True
StopIfGoingOffIdle     : False
RestartOnIdleResume    : False
IdleDuration           : 00:10:00
IdleTimeout            : 01:00:00
ShowInTaskScheduler    : True
RunElevated            : False
RunWithoutNetwork      : False
DoNotAllowDemandStart  : False
MultipleInstancePolicy : IgnoreNew
JobDefinition          :

The second command uses the **Set-ScheduledJobOpton** cmdlet to change the job options so the values of the WakeToRun and RunWithoutNetwork properties are $True. The command uses the *Passthru* parameter to return the trigger after the change.
PS C:\> Get-ScheduledJobOption -Name "DeployPackage" | Set-ScheduledJobOption -WakeToRun -RequireNetwork:$False -Passthru
StartIfOnBatteries     : False
StopIfGoingOnBatteries : True
WakeToRun              : True
StartIfNotIdle         : True
StopIfGoingOffIdle     : False
RestartOnIdleResume    : False
IdleDuration           : 00:10:00
IdleTimeout            : 01:00:00
ShowInTaskScheduler    : True
RunElevated            : False
RunWithoutNetwork      : True
DoNotAllowDemandStart  : False
MultipleInstancePolicy : IgnoreNewJobDefinition          :

此示例演示如何更改本地计算机上的计划作业的选项。

第一个命令使用 Get-ScheduledJobOption cmdlet 获取 DeployPackage 计划作业的作业选项。 输出显示 WakeToRun 和 RunElevated 属性设置为$False。

不需要此命令;它仅包含以显示选项更改的效果。

PS C:\> Invoke-Command -Computer "Server01" -ScriptBlock {Get-ScheduledJob | Get-ScheduledJobOption | Set-ScheduledJobOption -IdleTimeout 2:00:00}

此命令将 IdleTimeout 的值从一小时（默认值）更改为 Server01 计算机上所有计划作业的两小时。

该命令使用 Invoke-Command cmdlet 在 Server01 计算机上运行命令。

远程命令以获取计算机上的所有计划作业的 Get-ScheduledJob 命令开头。 计划作业通过管道传递给 Get-ScheduledJobOption cmdlet，该 cmdlet 获取计划作业的作业选项。 每个作业选项对象都包含一个 JobDefinition 属性，该属性包含计划作业，因此，即使已更改，选项对象仍与计划作业关联。

作业触发器通过管道传递给 Set-ScheduledJobOption cmdlet，该 cmdlet 会将 IdleTimeout 选项的值更改为两小时（2：00：00）。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将计划作业选项对象传递给 Set-ScheduledJobOption。

使用 Passthru 参数时，Set-ScheduledJobOption 返回更改的作业选项。 否则，此 cmdlet 不会生成任何输出。