Enable-JobTrigger

启用计划作业的作业触发器。

语法

Enable-JobTrigger
      [-InputObject] <ScheduledJobTrigger[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Enable-JobTrigger cmdlet 重新启用计划作业的作业触发器,例如使用 Disable-JobTrigger cmdlet 禁用的作业触发器。 启用和重新启用的作业触发器可以立即启动计划作业;无需重启 Windows 或 Windows PowerShell。

若要使用此 cmdlet,请使用 Get-JobTrigger cmdlet 获取作业触发器。 然后通过管道将作业触发器传递给 Enable-JobTrigger 或使用其 InputObject 参数。

若要启用作业触发器,Enable-JobTrigger cmdlet 会将作业触发器的 Enabled 属性设置为$True。

Enable-ScheduledJob 是 windows PowerShell 中包含的 PSScheduledJob 模块中的作业计划 cmdlet 集合之一。

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

此 cmdlet 已在 Windows PowerShell 3.0 中引入。

示例

示例 1:启用作业触发器

PS C:\> Get-JobTrigger -Name Backup-Archives -TriggerID 1 | Enable-JobTrigger

此命令在本地计算机上启用 Backup-Archives 计划作业的第一个触发器(ID=1)。

该命令使用 Get-JobTrigger cmdlet 来获取作业触发器。 管道运算符将作业触发器发送到 Enable-JobTrigger cmdlet,该 cmdlet 可启用它。

示例 2:启用所有作业触发器

PS C:\> Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

该命令使用 Get-ScheduledJob cmdlet 获取本地计算机上的计划作业。 管道运算符 (|) 将计划作业发送到 Get-JobTrigger cmdlet,该 cmdlet 可获取计划作业的所有作业触发器。 另一个管道运算符将作业触发器发送到 Enable-JobTrigger cmdlet,从而启用它们。

示例 3:在远程计算机上启用计划作业的作业触发器

PS C:\> Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "AtLogon"} | Enable-JobTrigger}

此命令在 Server01 远程计算机上的 DeployPackage 计划作业上重新启用 AtLogon 作业触发器。

该命令使用 Invoke-Command cmdlet 在 Server01 计算机上运行命令。 远程命令使用 Get-JobTrigger cmdlet 来获取 DeployPackage 计划作业的作业触发器。 管道运算符将作业触发器发送到仅返回 AtLogon 作业触发器的 Where-Object cmdlet。 管道运算符将 AtLogon 作业触发器发送到 Enable-JobTrigger cmdlet,从而启用它们。

示例 4:显示禁用的作业触发器

PS C:\> Get-ScheduledJob | Get-JobTrigger | where {!$_.Enabled} | Format-Table Id, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}}
Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
 1    Weekly 9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
 2    Daily  9/29/2011 1:00:00 AM              False   Backup-Archive
 1    Weekly 10/20/2011 11:00:00 PM {Friday}   False   Inventory
 1    Weekly 11/2/2011 2:00:00 PM   {Monday}   False   Inventory

此命令显示表中所有计划作业的所有已禁用作业触发器。 可以使用如下所示的命令来发现可能需要启用的作业触发器。

该命令使用 Get-ScheduledJob cmdlet 获取本地计算机上的计划作业。 管道运算符 (|) 将计划作业发送到 Get-JobTrigger cmdlet,该 cmdlet 可获取计划作业的所有作业触发器。 另一个管道运算符将作业触发器发送到 Where-Object cmdlet,该 cmdlet 仅返回禁用的作业触发器,即作业触发器的 Enabled 属性的值不是 (!) true。

另一个管道运算符将禁用的作业触发器发送到 Format-Table cmdlet,该 cmdlet 在表中显示作业触发器的选定属性。 这些属性包括一个新的 JobName 属性,该属性在作业触发器的 JobDefinition 属性中显示计划作业的名称。

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定要启用的作业触发器。 输入一个变量,其中包含 ScheduledJobTrigger 对象或键入 ScheduledJobTrigger 对象(如 Get-JobTrigger 命令)的命令或表达式。 还可以通过管道将 ScheduledJobTrigger 对象传递给 Enable-JobTrigger

类型:ScheduledJobTrigger[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PassThru

返回一个对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 不生成任何输出。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

ScheduledJobTrigger

可以通过管道将作业触发器传递给 Enable-JobTrigger

输出

None

此 cmdlet 不生成任何输出。

备注

  • 如果启用已启用的作业触发器,Enable-JobTrigger 不会生成错误或警告。