Add-JobTrigger (PowerShell 3.0+)

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.

Examples

Add a job trigger to a scheduled job:

PS C:\> $trigger64 = New-JobTrigger -Daily -At 5AM
PS C:\> Add-JobTrigger -Trigger $trigger64 -Name Job64

Add an AtStartup job trigger to all scheduled jobs on the local computer:

PS C:\> 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.


 
Copyright © 1999-2024 SS64.com
Some rights reserved