Partager via

Get-JobTrigger

  • Référence
Module:
PSScheduledJob

Obtient les déclencheurs de travaux planifiés.

Syntaxe

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

Description

L’applet de commande Get-JobTrigger Get-JobTrigger obtient les déclencheurs de travaux planifiés. Vous pouvez utiliser cette commande pour examiner les déclencheurs de travail ou diriger les déclencheurs de travail 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 travail ne sont pas enregistrés sur le disque indépendamment ; ils font partie d’un travail planifié. Pour obtenir un déclencheur de travail, spécifiez le travail planifié démarré par le déclencheur.

Utilisez les paramètres de l’applet de commande Get-JobTrigger 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 objets ScheduledJob, tels que ceux retournés par l’applet de commande Get-ScheduledJob, pour Get-JobTrigger.

Get-JobTrigger est une collection d’applets de commande de planification de travaux dans le module PSScheduledJob inclus dans Windows PowerShell.

Pour plus d’informations sur les travaux planifiés, consultez les rubriques À propos du 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é

PS C:\> Get-JobTrigger -Name "BackupJob"

La commande utilise le paramètre Name de Get-JobTrigger pour obtenir les déclencheurs de travail de la tâche planifiée BackupJob.

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

The first command uses the Get-ScheduledJob cmdlet to display the scheduled jobs on the local computer. The display includes the IDs of the scheduled jobs.
PS C:\> 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

The second command uses the **Get-JobTrigger** cmdlet to get the job trigger for the Test-HelpFiles job (ID = 3)
PS C:\> Get-JobTrigger -ID 3

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

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

PS C:\> Get-ScheduledJob -Name *Backup*, *Archive* | Get-JobTrigger

Cette commande obtient les déclencheurs de travail de tous les travaux qui ont sauvegarde ou archive dans leurs noms.

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

PS C:\> Invoke-Command -ComputerName Server01 { Get-ScheduledJob Backup | Get-JobTrigger -TriggerID 2 }

Cette commande obtient l’un des deux déclencheurs de travail d’un travail planifié sur un ordinateur distant.

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

Exemple 5 : Obtenir tous les déclencheurs de travail

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

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

La commande utilise le Get-ScheduledJob pour obtenir les travaux planifiés sur l’ordinateur local et les canaliser vers Get-JobTrigger, 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 de commande Format-Table. 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é

The command uses the Get-ScheduledJob cmdlet to get the Test-HelpFiles scheduled job. Then it uses the dot method (.) to get the JobTriggers property of the Test-HelpFiles scheduled job.
PS C:\> (Get-ScheduledJob Test-HelpFiles).JobTriggers

The second command uses the Get-ScheduledJob cmdlet to get all scheduled jobs on the local computer. It uses the ForEach-Object cmdlet to get the value of the JobTrigger property of each scheduled job.
PS C:\> Get-ScheduledJob | foreach {$_.JobTriggers}

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 de commande Get-JobTrigger pour obtenir des déclencheurs de travail. Les résultats sont identiques à l’utilisation de l’applet de commande Get-JobTrigger et les techniques peuvent être utilisées de manière interchangeable.

Exemple 7 : Comparer les déclencheurs de travail

The first command gets the job trigger of the ArchiveProjects scheduled job. The command pipes the job trigger to the Tee-Object cmdlet, which saves the job trigger in the $T1 variable and displays it at the command line.
PS C:\> 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

The second command gets the job trigger of the Test-HelpFiles scheduled job. The command pipes the job trigger to the Tee-Object cmdlet, which saves the job trigger in the $T2 variable and displays it at the command line.
PS C:\> 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

The third command compares the job triggers in the $t1 and $t2 variables. It uses the Get-Member cmdlet to get the properties of the job trigger in the $t1 variable. It pipes the properties to the ForEach-Object cmdlet, which compares each property to the properties of the job trigger in the $t2 variable by name. The command then pipes the differing properties to the Format-List cmdlet, which displays them in a list.The output indicates that, although the job triggers appear to be the same, the HelpFiles job trigger includes a random delay of three (3) minutes.
PS C:\> $T1 | Get-Member -Type Property | ForEach-Object { Compare-Object $T1 $T2 -Property $_.Name}
RandomDelay                                                 SideIndicator
-----------                                                 -------------
00:00:00                                                    =>
00:03:00                                                    <=

Cet exemple montre comment comparer les déclencheurs de travail de deux travaux planifiés.

Paramètres

-Id

Spécifie le numéro d’identification d’un travail planifié. 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 de commande Get-ScheduledJob.

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 un travail planifié. Entrez une variable qui contient objets ScheduledJob ou tapez une commande ou une expression qui obtient objets ScheduledJob, tels qu’une commande Get-ScheduledJob. Vous pouvez également diriger 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’un travail planifié. 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 de commande Get-ScheduledJob.

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 travail spécifiés. Entrez les ID de déclencheur d’un ou plusieurs déclencheurs de travail d’un travail planifié. Utilisez ce paramètre lorsque le travail planifié spécifié par l'Name , IDou paramètres 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é de Get-ScheduledJob vers Get-JobTrigger.

Sorties

ScheduledJobTrigger