Partager via

Enable-JobTrigger

  • Référence
Module:
PSScheduledJob

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

Syntax

Enable-JobTrigger
      [-InputObject] <ScheduledJobTrigger[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Enable-JobTrigger réactive les déclencheurs de travaux planifiés, tels que ceux qui ont été désactivés à l’aide de l’applet de commande Disable-JobTrigger. Les déclencheurs de tâche activés et réactivés peuvent démarrer des tâches planifiées immédiatement ; il est inutile de redémarrer Windows ou Windows PowerShell.

Pour utiliser cette applet de commande, utilisez l’applet de commande Get-JobTrigger pour obtenir les déclencheurs de travail. Ensuite, dirigez les déclencheurs de travail vers Enable-JobTrigger ou utilisez son paramètre InputObject .

Pour activer un déclencheur de travail, l’applet de commande Enable-JobTrigger définit la propriété Enabled du déclencheur de travail sur $True.

Enable-ScheduledJob est une collection d’applets de commande de planification de travaux dans le module PSScheduledJob qui est 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 : Activer un déclencheur de travail

PS C:\> Get-JobTrigger -Name Backup-Archives -TriggerID 1 | Enable-JobTrigger

Cette commande active le premier déclencheur (ID=1) de la tâche planifiée Backup-Archives sur l'ordinateur local.

La commande utilise l’applet de commande Get-JobTrigger pour obtenir le déclencheur de travail. Un opérateur pipeline envoie le déclencheur de tâche à l'applet de commande Enable-JobTrigger, qui l'active.

Exemple 2 : Activer tous les déclencheurs de travail

PS C:\> Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

La commande utilise l’applet de commande Get-ScheduledJob pour obtenir les travaux planifiés sur l’ordinateur local. Un opérateur de pipeline (|) envoie les travaux planifiés à l’applet de commande Get-JobTrigger, qui obtient tous les déclencheurs de travail des travaux planifiés. Un autre opérateur pipeline envoie les déclencheurs de tâche à l'applet de commande Enable-JobTrigger, qui les active.

Exemple 3 : Activer le déclencheur de travail d’un travail planifié sur un ordinateur distant

PS C:\> Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "AtLogon"} | Enable-JobTrigger}

Cette commande réactive les déclencheurs de tâche AtLogon sur la tâche planifiée DeployPackage sur l'ordinateur distant Server01.

La commande utilise l’applet de commande Invoke-Command pour exécuter les commandes sur l’ordinateur Server01. La commande distante utilise l’applet de commande Get-JobTrigger pour obtenir les déclencheurs de travail du travail planifié DeployPackage. Un opérateur de pipeline envoie les déclencheurs de travail à l’applet de commande Where-Object qui retourne uniquement les déclencheurs de travail AtLogon. Un opérateur de pipeline envoie les déclencheurs de travail AtLogon à l’applet de commande Enable-JobTrigger , qui les active.

Exemple 4 : Afficher les déclencheurs de travail désactivés

PS C:\> Get-ScheduledJob | Get-JobTrigger | where {!$_.Enabled} | Format-Table Id, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}}
Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
 1    Weekly 9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
 2    Daily  9/29/2011 1:00:00 AM              False   Backup-Archive
 1    Weekly 10/20/2011 11:00:00 PM {Friday}   False   Inventory
 1    Weekly 11/2/2011 2:00:00 PM   {Monday}   False   Inventory

Cette commande affiche tous les déclencheurs de tâche désactivés de toutes les tâches planifiées dans une table. Vous pouvez utiliser une commande similaire à celle-ci pour découvrir les déclencheurs de tâche qui doivent peut-être être activés.

La commande utilise l’applet de commande Get-ScheduledJob pour obtenir les travaux planifiés sur l’ordinateur local. Un opérateur de pipeline (|) envoie les travaux planifiés à l’applet de commande Get-JobTrigger, qui obtient tous les déclencheurs de travail des travaux planifiés. Un autre opérateur de pipeline envoie les déclencheurs de travail à l’applet de commande Where-Object, qui retourne uniquement les déclencheurs de travail qui sont désactivés, c’est-à-dire où la valeur de la propriété Enabled du déclencheur de travail n’est pas ( !) true.

Un autre opérateur de pipeline envoie les déclencheurs de travail désactivés à l’applet de commande Format-Table, qui affiche les propriétés sélectionnées des déclencheurs de travail dans une table. Les propriétés incluent une nouvelle propriété JobName qui affiche le nom de la tâche planifiée dans la propriété JobDefinition du déclencheur.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Spécifie le déclencheur de travail à activer. Entrez 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 un objet ScheduledJobTrigger vers Enable-JobTrigger.

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

-PassThru

Retourne un objet représentant l’élément que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

ScheduledJobTrigger

Vous pouvez diriger des déclencheurs de travail vers Enable-JobTrigger.

Sorties

None

Cette applet de commande ne génère aucune sortie.

Notes

  • Enable-JobTrigger ne génère pas d’erreurs ou d’avertissements si vous activez un déclencheur de travail déjà activé.