New-JobTrigger

New-JobTrigger
    -At <DateTime>
    [-RandomDelay <TimeSpan>]
    [-Once]
    [-RepetitionInterval <TimeSpan>]
    [-RepetitionDuration <TimeSpan>]
    [-RepeatIndefinitely]
    [<CommonParameters>]

New-JobTrigger
    -At <DateTime>
    [-DaysInterval <Int32>]
    [-RandomDelay <TimeSpan>]
    [-Daily]
    [<CommonParameters>]

New-JobTrigger
    -At <DateTime>
    -DaysOfWeek <DayOfWeek[]>
    [-WeeksInterval <Int32>]
    [-RandomDelay <TimeSpan>]
    [-Weekly]
    [<CommonParameters>]

New-JobTrigger
    [-RandomDelay <TimeSpan>]
    [-AtStartup]
    [<CommonParameters>]

New-JobTrigger
    [-RandomDelay <TimeSpan>]
    [-User <String>]
    [-AtLogOn]
    [<CommonParameters>]

New-JobTrigger cmdlet 创建一个作业触发器，该触发器按一次性或定期计划启动计划作业，或者在事件发生时启动计划作业。

可以使用 ScheduledJobTrigger 对象 New-JobTrigger 返回来设置新作业或现有计划作业的作业触发器。 还可以通过使用 Get-JobTrigger cmdlet 获取现有计划作业的作业触发器，或使用哈希表值来表示作业触发器来创建作业触发器。

创建作业触发器时，请查看由 New-ScheduledJobOption cmdlet 指定的选项的默认值。 这些选项与 任务计划程序中的相应选项具有相同的有效值和默认值，会影响计划作业的计划和时间。

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

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

此 cmdlet 已在 Windows PowerShell 3.0 中引入。

PS C:\> New-JobTrigger -Once -At "1/20/2012 3:00 AM"

此命令使用 New-JobTrigger cmdlet 创建一个仅启动计划作业的作业触发器。 At 参数的值是 Windows PowerShell 转换为 DateTime 对象的字符串。 At 参数值包括显式日期，而不仅仅是一个时间。 如果省略了日期，则会使用当前日期和上午 3：00 时间创建触发器，这可能表示过去的时间。

PS C:\> New-JobTrigger -Daily -At "4:15 AM" -DaysInterval 3
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/21/2012 4:15:00 AM                           True

此命令创建一个作业触发器，该触发器在凌晨 4：15 每隔 3 天启动计划作业。

由于 At 参数的值不包含日期，因此当前日期用作 DateTime 对象中的日期值。 如果日期和时间过去，则计划作业在下一次发生时启动，即 3 天后从 At 参数值开始。

PS C:\> New-JobTrigger -Weekly -DaysOfWeek Monday, Wednesday, Friday -At "23:00" -WeeksInterval 4
Id Frequency Time                  DaysOfWeek                  Enabled
-- --------- ----                  ----------                  -------
0  Weekly    9/21/2012 11:00:00 PM {Monday, Wednesday, Friday} True

此命令创建一个作业触发器，该触发器每隔 4 周在星期一、星期三和星期五 2300 小时（下午 11：00）启动计划作业。

还可以在整数中输入 DaysOfWeek 参数值，例如 -DaysOfWeek 1, 5。

PS C:\> New-JobTrigger -AtLogOn -User Domain01\Admin01

此命令创建一个作业触发器，每当域管理员登录到计算机时启动计划作业。

PS C:\> New-JobTrigger -Daily -At 1:00 -RandomDelay 00:20:00

此命令创建一个作业触发器，该触发器每天上午 1：00 启动计划作业。 该命令使用 RandomDelay 参数将最大延迟设置为 20 分钟。 因此，作业每天在上午 1：00 到上午 1：20 之间运行，间隔变化为伪随机。

可以使用随机延迟进行采样、负载均衡和其他管理任务。 设置延迟值时，请查看 New-ScheduledJobOption cmdlet 的有效值和默认值，并使用选项设置协调延迟。

The first command uses the **New-JobTrigger** cmdlet to create a job trigger that starts a job every Monday, Wednesday, and Friday at 12:01 AM. The command saves the job trigger in the $T variable.
PS C:\> $T = New-JobTrigger -Weekly -DaysOfWeek 1,3,5 -At 12:01AM


The second command uses the Register-ScheduledJob cmdlet to create a scheduled job that starts a job every Monday, Wednesday, and Friday at 12:01 AM. The value of the *Trigger* parameter is the trigger that is stored in the $T variable.
PS C:\> Register-ScheduledJob -Name Test-HelpFiles -FilePath C:\Scripts\Test-HelpFiles.ps1 -Trigger $T

这些命令使用作业触发器创建新的计划作业。

PS C:\> Add-JobTrigger -Name SynchronizeApps -Trigger (New-JobTrigger -Daily -At 3:10AM)

此示例演示如何将作业触发器添加到现有计划作业。 可以将多个作业触发器添加到任何计划作业。

该命令使用 Add-JobTrigger cmdlet 将作业触发器添加到 SynchronizeApps 计划作业。 Trigger 参数的值是 New-JobTrigger 命令，该命令每天凌晨 3：10 运行作业。

命令完成后，SynchronizeApps 是计划作业，在作业触发器指定的时间运行。

PS C:\> New-JobTrigger -Once -At "09/12/2013 1:00:00" -RepetitionInterval (New-TimeSpan -Hours 1) -RepetitionDuration (New-Timespan -Hours 48)

此命令创建一个作业触发器，该触发器在 2013 年 9 月 12 日上午 1：00 开始每隔 60 分钟运行一次作业 48 小时。

PS C:\> Get-JobTrigger -Name SecurityCheck | Set-JobTrigger -RepetitionInterval 0:00 -RepetitionDuration 0:00

此命令强行停止 SecurityCheck 作业，该作业将每隔 60 分钟触发一次，直到其作业触发器过期。

为防止作业重复，该命令使用 Get-JobTrigger 获取 SecurityCheck 作业的作业触发器，并使用 Set-JobTrigger cmdlet 将作业触发器的重复间隔和重复持续时间更改为零（0）。

PS C:\> New-JobTrigger -Once -At "9/21/2012 0am" -RepetitionInterval (New-TimeSpan -Hour 12) -RepetitionDuration ([TimeSpan]::MaxValue)

以下命令创建一个作业触发器，该触发器每隔 12 小时运行一次计划作业，以无限期运行一次。 日程安排将于明天午夜（上午0：00）开始（2012/9/21）。

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

不能通过管道将输入传递给此 cmdlet。

• 作业触发器不会保存到磁盘。 但是，计划作业将保存到磁盘，可以使用 Get-JobTrigger 获取任何计划作业的作业触发器。

• New-JobTrigger 不会阻止你创建不会运行计划作业的作业触发器，例如过去日期的一次性触发器。

• Register-ScheduledJob cmdlet 接受 ScheduledJobTrigger 对象，例如由 New-JobTrigger 或 Get-JobTrigger cmdlet 返回的对象，或具有触发器值的哈希表。

  若要提交哈希表，请使用以下键。

  @{Frequency="Once" (or Daily, Weekly, AtStartup, AtLogon);At="3am" （或任何有效的时间字符串）; DaysOfWeek="Monday", "Wednesday" （或日期名称的任意组合）; Interval=2 （或任何有效的频率间隔）; RandomDelay="30minutes" （或任何有效的 timespan 字符串）; User="Domain1\User01 （或任何有效用户;仅用于 AtLogon 频率值） }