Add a job trigger to a scheduled job.
A "job trigger" starts a scheduled job on a one-time or recurring schedule or when an event occurs.
To identify the job triggers to add, use the -Trigger parameter.
To identify the scheduled job to which the triggers are added, use the -Name, -ID, or -InputObject parameters.
To create job triggers for the value of the Trigger parameter, use the New-JobTrigger cmdlet or use a hash table.
Syntax Add-JobTrigger[-InputObject] ScheduledJobDefinition[] [-Trigger] ScheduledJobTrigger[] [CommonParameters] Add-JobTrigger [-Id] Int32[] [-Trigger] ScheduledJobTrigger[] [CommonParameters] Add-JobTrigger [-Name] String[] [-Trigger] ScheduledJobTrigger[] [CommonParameters] key -Id Int32[] Tthe identification numbers of the scheduled jobs. Add-JobTrigger adds the job trigger to the specified scheduled jobs. To get the identification number of scheduled jobs on the local computer or a remote computer, use the Get-ScheduledJob. -InputObject ScheduledJobDefinition[] The scheduled jobs. Enter a variable that contains ScheduledJob objects or type a command or expression that gets ScheduledJob objects, such as Get-ScheduledJob. You can also pipe ScheduledJob objects to Add-JobTrigger. -Name String[] The names of the scheduled jobs. Wildcards are supported. Add-JobTrigger adds the job triggers to the specified scheduled jobs. To get the names of scheduled jobs, use Get-ScheduledJob. -Trigger ScheduledJobTrigger[] The job triggers to add. Enter a hash table that specifies job triggers or a variable that contains ScheduledJobTrigger objects, or type a command or expression that gets ScheduledJobTrigger objects, such as Get-JobTrigger. You can also pipe ScheduledJobTrigger objects to Add-JobTrigger. CommonParameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable, -OutBuffer -PipelineVariable, -OutVariable.
Examples
Add a job trigger to a scheduled job:
C:\PS> $trigger64 = New-JobTrigger -Daily -At 5AM
C:\PS> Add-JobTrigger -Trigger $trigger64 -Name Job64
Add an AtStartup job trigger to all scheduled jobs on the local computer:
C:\PS> Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)
Copy a job trigger:
PS C:\> $trigger = Get-JobTrigger -Name BackupArchives
PS C:\> Add-JobTrigger -Name TestBackup, BackupLogs -Trigger $trigger
“History teaches us that men and nations behave wisely once they have exhausted all other alternatives” ~ Abba Eban
Related PowerShell Cmdlets:
Scheduler cmdlets - Get/Set scheduled jobs.
Get-JobTrigger - Get the job triggers of scheduled jobs.
New-JobTrigger - Create a new Job Trigger.
Set-JobTrigger - Change the job trigger of a scheduled job.