Partager via

Enable-JobTrigger

  • Référence
Module:
PSScheduledJob

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

Syntaxe

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

Description

L’applet Enable-JobTrigger de commande réactive les déclencheurs de travaux planifiés, tels que ceux qui ont été désactivés à l’aide de l’applet Disable-JobTrigger de commande. 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 Get-JobTrigger de commande pour obtenir les déclencheurs de travail. Dirigez ensuite les déclencheurs de travail vers Enable-JobTrigger ou utilisez son paramètre InputObject .

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

Enable-ScheduledJob 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 : Activer un déclencheur de travail

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 Get-JobTrigger de commande pour obtenir le déclencheur de travail. Un opérateur de pipeline envoie le déclencheur de travail à l’applet Enable-JobTrigger de commande, qui l’active.

Exemple 2 : Activer tous les déclencheurs de travail

Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

La commande utilise l’applet Get-ScheduledJob de commande pour obtenir les travaux planifiés sur l’ordinateur local. Un opérateur de pipeline (|) envoie les travaux planifiés à l’applet Get-JobTrigger de commande, ce 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 Enable-JobTrigger de commande, ce qui les active.

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

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

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

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 Get-ScheduledJob de commande pour obtenir les travaux planifiés sur l’ordinateur local. Un opérateur de pipeline (|) envoie les travaux planifiés à l’applet Get-JobTrigger de commande, ce 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 Where-Object de commande, qui retourne uniquement les déclencheurs de travail désactivés, autrement dit, 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 Format-Table de commande, 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 du travail planifié dans la propriété JobDefinition du déclencheur de travail.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 , tels qu’une Get-JobTrigger commande. Vous pouvez également diriger un objet ScheduledJobTrigger vers Enable-JobTrigger.

Type:ScheduledJobTrigger[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

ScheduledJobTrigger

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

Sorties

None

Cette applet de commande ne retourne pas de 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é.