Partager via

Add-JobTrigger

  • Référence
Module:
PSScheduledJob

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

Syntaxe

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

Description

L’applet Add-JobTrigger de commande ajoute des déclencheurs de travail aux travaux planifiés. 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 Déclencheur pour Add-JobTrigger identifier les déclencheurs de travail à ajouter. Utilisez les paramètres Name, ID ou InputObject pour Add-JobTrigger 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 New-JobTrigger de commande ou utilisez une table de hachage pour spécifier le déclencheur de travail.

Add-JobTrigger est l’une des collections 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é

$Daily = New-JobTrigger -Daily -At 3AMPS
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 New-JobTrigger de commande pour créer un déclencheur de travail qui démarre un travail planifié tous les jours à 3 h 00. La commande enregistre le déclencheur de travail dans la $Daily variable.

La deuxième commande utilise l’applet Add-JobTrigger de commande pour ajouter le déclencheur de travail dans la variable $Startup au travail planifié TestJob.

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

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 l’option Get-ScheduledJob pour obtenir tous les travaux planifiés sur l’ordinateur. Il utilise un opérateur de pipeline (|) pour envoyer les travaux à l’applet Add-JobTrigger de commande, ce qui ajoute le déclencheur de travail à chacun des travaux planifiés. La valeur du paramètre Déclencheur est une New-JobTrigger commande qui crée le déclencheur de travail AtStartup.

Exemple 3 : Copier un déclencheur de travail

$T = Get-JobTrigger -Name "BackupArchives"
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 Get-JobTrigger de commande pour obtenir le déclencheur de travail de la tâche planifiée BackupArchives. La commande enregistre le déclencheur dans la variable $t.

La deuxième commande utilise l’applet Add-JobTrigger de commande pour ajouter le déclencheur de travail dans $t aux travaux planifiés TestBackup et BackupLogs.

Paramètres

-Id

Spécifie les numéros d'identification des tâches planifiées. Add-JobTrigger ajoute le déclencheur de travail aux travaux planifiés spécifiés.

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

Type:Int32[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 Get-ScheduledJob commande. Vous pouvez également diriger des objets ScheduledJob vers Add-JobTrigger.

Type:ScheduledJobDefinition[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie les noms des tâches planifiées. Add-JobTrigger ajoute les déclencheurs de travail aux travaux planifiés spécifiés. 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 Get-ScheduledJob de commande.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 , tels qu’une Get-JobTrigger commande. Vous pouvez également diriger des objets ScheduledJobTrigger vers Add-JobTrigger.

Type:ScheduledJobTrigger[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

ScheduledJobTrigger

Vous pouvez diriger un déclencheur de travail vers cette applet de commande.

ScheduledJobDefinition

Vous pouvez diriger un travail planifié vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.