Disable-JobTrigger

参考

模块:: PSScheduledJob

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

语法

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

说明

Disable-JobTrigger cmdlet 临时禁用计划作业的作业触发器。该禁用操作会保留所有作业触发器属性，但它会阻止作业触发器启动计划作业。

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

若要禁用作业触发器，Disable-JobTrigger cmdlet 应将该作业触发器的 Enabled 属性设置为 $False。若要重新启用作业触发器，请使用 Enable-JobTrigger cmdlet，它将作业触发器的 Enabled 属性设置为 $True。禁用某个作业触发器不会像使用 Disable-ScheduledJob cmdlet 那样禁用计划作业，但如果禁用所有作业触发器，则效果与禁用计划作业相同。

如果禁用了计划作业或者禁用了计划作业的所有作业触发器，你仍然可以使用 Start-Job cmdlet 来启动该作业，或将禁用的计划作业用作模板。

Disable-ScheduledJob 是 PSScheduledJob 模块（包含在 Windows PowerShell 中）中的一系列作业计划 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 | Disable-JobTrigger

该命令使用 Get-JobTrigger cmdlet 来获取作业触发器。管道运算符 (|) 将作业触发器发送到 Disable-JobTrigger cmdlet，此 cmdlet 将其禁用。

示例 2：禁用所有作业触发器

Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger
Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger |
    Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}} -AutoSize

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 来获取 Backup-Archives 和 Inventory 计划作业。一个管道运算符 (|) 将计划作业发送到 Get-JobTrigger cmdlet，此 cmdlet 从计划作业中获取所有作业触发器。另一个管道运算符将作业触发器发送到 Disable-JobTrigger cmdlet，此 cmdlet 将它们禁用。第一个命令使用 Get-ScheduledJob cmdlet 获取作业，因为其 Name 参数接受多个名称。

第二个命令显示结果。该命令重复 Get-ScheduledJob 和 Get-JobTrigger 命令。管道运算符将作业触发器发送到 Format-Table cmdlet，此 cmdlet 在表中显示作业触发器。 Format-Table 命令添加一个 JobName 属性，该属性显示作业触发器对象的 JobDefinition 属性中的计划作业的 Name 属性值。

以下命令禁用两个计划作业上的所有作业触发器并显示结果。

示例 3：禁用远程计算机上计划作业的作业触发器

此示例禁用远程计算机上的计划作业的每日作业触发器

Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "Daily"} | Disable-JobTrigger}

该命令使用 Invoke-Command cmdlet 在 Server01 计算机上运行命令。远程命令使用 Get-JobTrigger cmdlet 获取 DeployPackage 计划作业的作业触发器。管道运算符将作业触发器发送到 Where-Object cmdlet，此 cmdlet 仅返回每日作业触发器。管道运算符将各个每日作业触发器发送到 Disable-JobTrigger cmdlet，此 cmdlet 将它们禁用。

参数

-Confirm

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

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

-InputObject

指定要禁用的作业触发器。输入包含 ScheduledJobTrigger 对象的变量，或者键入可获取 ScheduledJobTrigger 对象的命令或表达式，例如 Get-JobTrigger 命令。还可以通过管道将 ScheduledJobTrigger 对象传递给 Disable-JobTrigger。

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

-PassThru

返回一个代表你所处理的项目的对象。默认情况下，此 cmdlet 将不产生任何输出。

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

-WhatIf

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

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

输入

ScheduledJobTrigger

你可以通过管道将作业触发器传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。

备注

如果你禁用某个已被禁用的作业触发器，Disable-JobTrigger 不会生成错误或警告。

通过