Add-JobTrigger

参考

模块:: PSScheduledJob

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

语法

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

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

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

说明

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

作业触发器在一次性或定期计划或事件发生时启动计划作业。

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

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

Add-JobTrigger 是 Windows PowerShell 中包含的 PSScheduledJob 模块中的作业计划 cmdlet 集合之一。

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

此 cmdlet 已在 Windows PowerShell 3.0 中引入。

示例

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

PS C:\> $Daily = New-JobTrigger -Daily -At 3AMPS
PS C:\> Add-JobTrigger -Trigger $Daily -Name "TestJob"

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

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

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

示例 2：向多个计划作业添加作业触发器

PS C:\> Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

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

示例 3：复制作业触发器

PS C:\> $T = Get-JobTrigger -Name "BackupArchives"
PS C:\> Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

这些命令从 BackupArchives 计划作业复制作业触发器，并将其添加到 TestBackup 和 BackupLogs 计划作业。

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

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

参数

-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

输入

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger, Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

可以通过管道将作业触发器或计划作业传递给 Add-JobTrigger。

输出

None

此 cmdlet 不返回任何输出。

通过