Partager via

Disable-JobTrigger

  • Référence
Module:
PSScheduledJob

Désactive les déclencheurs des tâches planifiées.

Syntaxe

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

Description

L’applet Disable-JobTrigger de commande désactive temporairement les déclencheurs de travaux planifiés. La désactivation conserve toutes les propriétés de déclencheur de tâche, mais l'empêche de démarrer la tâche planifiée.

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 Disable-JobTrigger ou utilisez son paramètre InputObject .

Pour désactiver un déclencheur de travail, l’applet Disable-JobTrigger de commande définit la propriété Enabled du déclencheur $Falsede travail sur . Pour réactiver le déclencheur de travail, utilisez l’applet Enable-JobTrigger de commande, qui définit la propriété Enabled du déclencheur de travail sur $True. La désactivation d’un déclencheur de travail ne désactive pas la tâche planifiée, telle qu’elle est effectuée par l’applet Disable-ScheduledJob de commande, mais si vous désactivez tous les déclencheurs de travail, l’effet est identique à la désactivation du travail planifié.

Si vous désactivez un travail planifié ou désactivez tous les déclencheurs de travail planifiés d’un travail planifié, vous pouvez toujours démarrer le travail à l’aide de l’applet Start-Job de commande ou utiliser le travail planifié désactivé comme modèle.

Disable-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 : Désactiver un déclencheur de travail

Cet exemple désactive le premier déclencheur d’un travail planifié sur l’ordinateur local.

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

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 Disable-JobTrigger de commande, ce qui le désactive.

Exemple 2 : Désactiver tous les déclencheurs de travail

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

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

La première commande utilise l’applet Get-ScheduledJob de commande pour obtenir les Backup-Archives travaux planifiés et l’inventaire. 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 Disable-JobTrigger de commande, ce qui les désactive. La première commande utilise l’applet Get-ScheduledJob de commande pour obtenir les travaux, car son paramètre Name prend plusieurs noms.

La deuxième commande affiche les résultats. La commande répète et Get-ScheduledJob Get-JobTrigger commande. Un opérateur de pipeline envoie les déclencheurs de travail à l’applet Format-Table de commande, qui affiche les déclencheurs de travail dans une table. La Format-Table commande ajoute une propriété JobName qui affiche la valeur de la propriété Name du travail planifié dans la propriété JobDefinition de l’objet déclencheur de travail.

Ces commandes désactivent tous les déclencheurs de tâche sur deux tâches planifiées et affichent les résultats.

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

Cet exemple désactive les déclencheurs de travail quotidiens pour un travail planifié sur un ordinateur distant

Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "Daily"} | Disable-JobTrigger}

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 quotidiens. Un opérateur de pipeline envoie les déclencheurs de travail quotidiens à l’applet Disable-JobTrigger de commande, ce qui les désactive.

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 tâche à désactiver. 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 Disable-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

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