Partager via

Add-JobTrigger

  • Référence
Module:
PSScheduledJob

Ajoute des déclencheurs aux tâches planifiées.

Syntax

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]

Description

L'applet de commande Add-JobTrigger ajoute des déclencheurs aux tâches planifiées. Vous pouvez l'utiliser pour ajouter plusieurs déclencheurs à plusieurs tâches planifiées.

Un déclencheur de travail démarre un travail planifié selon une planification ponctuelle ou périodique, ou lorsqu’un événement se produit.

Utilisez le paramètre Trigger de Add-JobTrigger pour identifier les déclencheurs de travail à ajouter. Utilisez les paramètres Name, ID ou InputObject de Add-JobTrigger pour identifier le travail planifié auquel les déclencheurs sont ajoutés.

Pour créer des déclencheurs de travail pour la valeur du paramètre Trigger , utilisez l’applet de commande New-JobTrigger ou utilisez une table de hachage pour spécifier le déclencheur de travail.

Add-JobTrigger fait partie d’une collection d’applets de commande de planification de travaux dans le module PSScheduledJob inclus dans Windows PowerShell.

Pour plus d'informations sur les tâches planifiées, consultez les rubriques À propos dans le module PSScheduledJob. Importez le module PSScheduledJob, puis tapez : Get-Help about_Scheduled* ou consultez about_Scheduled_Jobs.

Cette applet de commande a été introduite dans Windows PowerShell 3.0.

Exemples

Exemple 1 : Ajouter un déclencheur de travail à un travail planifié

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

Ces commandes ajoutent le déclencheur Daily à la tâche planifiée TestJob.

La première commande utilise l’applet de commande New-JobTrigger pour créer un déclencheur de travail qui démarre un travail planifié tous les jours à 3h00. La commande enregistre le déclencheur de travail dans la variable $Daily.

La deuxième commande utilise l'applet de commande Add-JobTrigger pour ajouter le déclencheur de tâche de la variable $Startup à la tâche planifiée TestJob.

Exemple 2 : Ajouter un déclencheur de travail à plusieurs travaux planifiés

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

Cette commande ajoute un déclencheur de tâche AtStartup à toutes les tâches planifiées sur l'ordinateur local. Il utilise le Get-ScheduledJob pour obtenir tous les travaux planifiés sur l’ordinateur. Elle utilise un opérateur pipeline (|) pour envoyer les tâches à l'applet de commande Add-JobTrigger, qui ajoute le déclencheur à chacune des tâches planifiées. La valeur du paramètre Trigger est une commande New-JobTrigger qui crée le déclencheur de travail AtStartup.

Exemple 3 : Copier un déclencheur de travail

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

Ces commandes copient le déclencheur de tâche de la tâche planifiée BackupArchives et l'ajoutent aux tâches planifiées TestBackup et BackupLogs.

La première commande utilise l’applet de commande Get-JobTrigger pour obtenir le déclencheur de travail du travail planifié BackupArchives. La commande enregistre le déclencheur dans la variable $t.

La deuxième commande utilise l'applet de commande Add-JobTrigger pour ajouter le déclencheur de tâche dans $t aux tâches planifiées TestBackup et BackupLogs.

Paramètres

-Id

Spécifie les numéros d'identification des tâches planifiées. Add-JobTrigger ajoute les déclencheurs aux tâches planifiées spécifiées.

Pour obtenir le numéro d’identification des travaux planifiés sur l’ordinateur local ou un ordinateur distant, utilisez l’applet de commande Get-ScheduledJob.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Spécifie les tâches planifiées. Entrez une variable qui contient des objets ScheduledJob ou tapez une commande ou une expression qui obtient des objets ScheduledJob , comme une commande Get-ScheduledJob. Vous pouvez également diriger des objets ScheduledJob vers Add-JobTrigger.

Type:ScheduledJobDefinition[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie les noms des tâches planifiées. Add-JobTrigger ajoute les déclencheurs aux tâches planifiées spécifiées. Les caractères génériques sont pris en charge.

Pour obtenir les noms des travaux planifiés sur l’ordinateur local ou un ordinateur distant, utilisez l’applet de commande Get-ScheduledJob.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Trigger

Spécifie les déclencheurs de travail à ajouter. Entrez une table de hachage qui spécifie des déclencheurs de travail ou une variable qui contient des objets ScheduledJobTrigger , ou tapez une commande ou une expression qui obtient des objets ScheduledJobTrigger , comme une commande Get-JobTrigger. Vous pouvez également diriger des objets ScheduledJobTrigger vers Add-JobTrigger.

Type:ScheduledJobTrigger[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

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

Vous pouvez diriger des déclencheurs de tâche ou des tâches planifiées vers Add-JobTrigger.

Sorties

None

Cette applet de commande ne retourne aucune sortie.