Add-JobTrigger

参考

模块:: PSScheduledJob

将作业触发器添加到计划作业。

语法

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<CommonParameters>]

说明

Add-JobTrigger cmdlet 将作业触发器添加到计划作业。它可用于将多个触发器添加到多个计划作业。

作业触发器可按一次性或循环计划或者在事件发生时启动计划作业。

使用 Add-JobTrigger 的 Trigger 参数来标识要添加的作业触发器。使用 Add-JobTrigger 的 Name、ID 或 InputObject 参数来标识将触发器添加到的计划作业。

若要针对 Trigger 参数的值创建作业触发器，请使用 New-JobTrigger cmdlet 或使用哈希表指定作业触发器。

Add-JobTrigger 是 PSScheduledJob 模块（包含在 Windows PowerShell 中）中的一系列作业计划 cmdlet 之一。

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

此 cmdlet 是在 Windows PowerShell 3.0 中引入的。

示例

示例 1：将作业触发器添加到计划作业

$Daily = New-JobTrigger -Daily -At 3AMPS
Add-JobTrigger -Trigger $Daily -Name "TestJob"

以下命令将每日作业触发器添加到 TestJob 计划作业。

第一个命令使用 New-JobTrigger cmdlet 创建每天凌晨 3:00 启动计划作业的作业触发器。此命令将作业触发器保存在 $Daily 变量中。

第二个命令使用 Add-JobTrigger cmdlet 将 $Startup 变量中的作业触发器添加到 TestJob 计划作业。

示例 2：将某个作业触发器添加到多个计划作业

Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

此命令将一个 AtStartup 作业触发器添加到本地计算机上的所有计划作业。它使用 Get-ScheduledJob 获取该计算机上的所有计划作业。它使用管道运算符 (|) 将作业发送到 Add-JobTrigger cmdlet，此 cmdlet 将作业触发器添加到每个计划作业。 Trigger 参数的值是一个 New-JobTrigger 命令，该命令创建 AtStartup 作业触发器。

示例 3：复制作业触发器

$T = Get-JobTrigger -Name "BackupArchives"
Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

以下命令从 BackupArchives 计划作业复制作业触发器，然后将它添加到 TestBackup 和 BackupLogs 计划作业。

第一个命令使用 Get-JobTrigger cmdlet 获取 BackupArchives 计划作业的作业触发器。此命令将该触发器保存在 $t 变量中。

第二个命令使用 Add-JobTrigger cmdlet 将 $t 中的作业触发器添加到 TestBackup 和 BackupLogs 计划作业。

参数

-Id

指定计划作业的标识号。 Add-JobTrigger 将作业触发器添加到指定的计划作业。

若要获取本地计算机或远程计算机上的计划作业的标识号，请使用 Get-ScheduledJob cmdlet。

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

-InputObject

指定计划作业。请输入包含 ScheduledJob 对象的变量，或者键入获取 ScheduledJob 对象的命令或表达式，例如 Get-ScheduledJob 命令。还可以通过管道将 ScheduledJob 对象传递给 Add-JobTrigger。

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

-Name

指定计划作业的名称。 Add-JobTrigger 将作业触发器添加到指定的计划作业。支持通配符。

若要获取本地计算机或远程计算机上的计划作业的名称，请使用 Get-ScheduledJob cmdlet。

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

-Trigger

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

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

输入

ScheduledJobTrigger

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

ScheduledJobDefinition

你可以通过管道将计划作业传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。

通过