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.