Partager via

Get-JobTrigger

  • Référence
Module:
PSScheduledJob

Obtient les déclencheurs des tâches planifiées.

Syntaxe

Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Id] <Int32>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Name] <String>
   [<CommonParameters>]

Description

L’applet Get-JobTrigger de commande obtient les déclencheurs de travaux planifiés. Vous pouvez utiliser cette commande pour examiner les déclencheurs de tâche ou pour les diriger vers d'autres applets de commande.

Un déclencheur de travail définit une planification ou des conditions périodiques pour démarrer un travail planifié. Les déclencheurs de tâche ne sont pas enregistrés sur le disque de manière indépendante ; ils font partie d'une tâche planifiée. Pour obtenir un déclencheur de tâche, spécifiez la tâche planifiée que le déclencheur démarre.

Utilisez les paramètres de l’applet Get-JobTrigger de commande pour identifier les travaux planifiés. Vous pouvez identifier les travaux planifiés par leurs noms ou numéros d’identification, ou en entrant ou en pipissant des objets ScheduledJob, tels que ceux retournés par l’applet Get-ScheduledJob de commande.Get-JobTrigger

Get-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 : Obtenir un déclencheur de travail par nom de travail planifié

Get-JobTrigger -Name "BackupJob"

La commande utilise le paramètre Name de Get-JobTrigger pour obtenir les déclencheurs de travail du BackupJob travail planifié.

Exemple 2 : Obtenir un déclencheur de travail par ID

L’exemple utilise le paramètre ID de Get-JobTrigger pour obtenir les déclencheurs de travail d’un travail planifié.

Get-ScheduledJob

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProjects {1}             \\Server\Share\Archive-Projects.ps1      True
2          Backup          {1,2}           \\Server\Share\Run-Backup.ps1            True
3          Test-HelpFiles  {1}             \\Server\Share\Test-HelpFiles.ps1        True
4          TestJob         {}              \\Server\Share\Run-AllTests.ps1          True

Get-JobTrigger -ID 3

La première commande utilise l’applet Get-ScheduledJob de commande pour afficher les travaux planifiés sur l’ordinateur local. L’affichage inclut les ID des travaux planifiés.

La deuxième commande utilise l’applet Get-JobTrigger de commande pour obtenir le déclencheur de travail pour le Test-HelpFiles travail (dont l’ID est 3).

Exemple 3 : Obtenir des déclencheurs de travail en pipant un travail

Cet exemple obtient les déclencheurs de travail des travaux qui ont des noms correspondants.

Get-ScheduledJob -Name *Backup*, *Archive* | Get-JobTrigger

Cette commande obtient les déclencheurs de travail de tous les travaux qui ont Backup ou Archive dans leur nom.

Exemple 4 : Obtenir le déclencheur de travail d’un travail sur un ordinateur distant

Cet exemple obtient les déclencheurs d’un travail planifié sur un ordinateur distant.

Invoke-Command -ComputerName Server01 { Get-ScheduledJob Backup | Get-JobTrigger -TriggerID 2 }

La commande utilise l’applet Invoke-Command de commande pour exécuter une commande sur l’ordinateur Server01. Il utilise l’applet Get-ScheduledJob de commande pour obtenir le Backup travail planifié, qu’il canalise vers l’applet Get-JobTrigger de commande. Il utilise le paramètre TriggerID pour obtenir uniquement le deuxième déclencheur.

Exemple 5 : Obtenir tous les déclencheurs de travail

Cet exemple obtient tous les déclencheurs de travail de tous les travaux planifiés sur l’ordinateur local.

Get-ScheduledJob | Get-JobTrigger |
    Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="ScheduledJob";Expression={$_.JobDefinition.Name}} -AutoSize

Id Frequency At                    DaysOfWeek Enabled ScheduledJob
-- --------- --                    ---------- ------- ------------
1    Weekly  9/28/2011 3:00:00 AM  {Monday}   True    Backup
1    Daily   9/27/2011 11:00:00 PM            True    Test-HelpFiles

La commande utilise la Get-ScheduledJob commande pour obtenir les travaux planifiés sur l’ordinateur local et les canaliser vers Get-JobTrigger, ce qui obtient le déclencheur de travail de chaque travail planifié (le cas échéant).

Pour ajouter le nom du travail planifié à l’affichage du déclencheur de travail, la commande utilise la fonctionnalité de propriété calculée de l’applet Format-Table de commande. Outre les propriétés du déclencheur de travail affichées par défaut, la commande crée une propriété ScheduledJob qui affiche le nom du travail planifié.

Exemple 6 : Obtenir la propriété de déclencheur de travail d’un travail planifié

Cet exemple montre différentes méthodes pour afficher la propriété JobTrigger d’un travail planifié.

(Get-ScheduledJob Test-HelpFiles).JobTriggers
Get-ScheduledJob | foreach {$_.JobTriggers}

La première commande utilise l’applet Get-ScheduledJob de commande pour obtenir le Test-HelpFiles travail planifié. Ensuite, il utilise la méthode dot (.) pour obtenir la propriété JobTriggers du Test-HelpFiles travail planifié.

La deuxième commande utilise l’applet Get-ScheduledJob de commande pour obtenir tous les travaux planifiés sur l’ordinateur local. Il utilise l’applet ForEach-Object de commande pour obtenir la valeur de la propriété JobTriggers de chaque travail planifié.

Les déclencheurs de travail d’un travail planifié sont stockés dans la propriété JobTriggers du travail. Cet exemple montre des alternatives à l’utilisation de l’applet Get-JobTrigger de commande pour obtenir des déclencheurs de travail. Les résultats sont identiques à l’utilisation de l’applet Get-JobTrigger de commande et les techniques peuvent être utilisées de manière interchangeable.

Exemple 7 : Comparer les déclencheurs de travail

Get-ScheduledJob -Name ArchiveProjects | Get-JobTrigger | Tee-Object -Variable t1

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

Get-ScheduledJob -Name "Test-HelpFiles" | Get-JobTrigger | Tee-Object -Variable t2

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

$t1| Get-Member -Type Property | ForEach-Object { Compare-Object $t1 $t2 -Property $_.Name}

RandomDelay                                                 SideIndicator
-----------                                                 -------------
00:00:00                                                    =>
00:03:00                                                    <=

La première commande obtient le déclencheur de travail du ArchiveProjects travail planifié. La commande canalise le déclencheur de travail vers l’applet Tee-Object de commande, qui enregistre le déclencheur de travail dans la $t1 variable et l’affiche sur la ligne de commande.

La deuxième commande obtient le déclencheur de travail du Test-HelpFiles travail planifié. La commande canalise le déclencheur de travail vers l’applet Tee-Object de commande, qui enregistre le déclencheur de travail dans la $t2 variable et l’affiche sur la ligne de commande.

La troisième commande compare les déclencheurs de travail dans les $t1 variables et $t 2. Il utilise l’applet Get-Member de commande pour obtenir les propriétés du déclencheur de travail dans la variable $t 1. Il canalise les propriétés à l’applet ForEach-Object de commande, qui compare chaque propriété aux propriétés du déclencheur de travail dans la $t2 variable par nom. La commande canalise ensuite les propriétés différentes à l’applet Format-List de commande, qui les affiche dans une liste. La sortie indique que, bien que les déclencheurs de travail semblent être identiques, le HelpFiles déclencheur de travail inclut un délai aléatoire de trois (3) minutes.

Cet exemple montre comment comparer les déclencheurs de deux tâches planifiées.

Paramètres

-Id

Spécifie le numéro d'identification d'une tâche planifiée. Get-JobTrigger obtient le déclencheur de travail du travail planifié spécifié.

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 une tâche planifiée. 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 Get-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 le nom d'une tâche planifiée. Get-JobTrigger obtient le déclencheur de travail du travail planifié spécifié. 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

-TriggerId

Obtient les déclencheurs de tâche spécifiés. Entrez les ID d'un ou de plusieurs déclencheurs de tâche d'une tâche planifiée. Utilisez ce paramètre lorsque le travail planifié spécifié par les paramètres Name, ID ou InputObject a plusieurs déclencheurs de travail.

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

Entrées

ScheduledJobDefinition

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

Sorties

ScheduledJobTrigger

Cette applet de commande retourne le déclencheur du travail planifié.