Partager via

Disable-JobTrigger

  • Référence
Module:
PSScheduledJob

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

Syntax

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

Description

L'applet de commande Disable-JobTrigger désactive temporairement les déclencheurs des tâches planifiées. 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 de commande Get-JobTrigger pour obtenir les déclencheurs de travail. Ensuite, dirigez les déclencheurs de tâche vers Disable-JobTrigger ou utilisez son paramètre InputObject.

Pour désactiver un déclencheur de travail, l’applet de commande Disable-JobTrigger définit la propriété Enabled du déclencheur de travail sur $False. Pour réactiver le déclencheur de travail, utilisez l’applet de commande Enable-JobTrigger, 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 le travail planifié, par exemple par l’applet de commande Disable-ScheduledJob, 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 d’un travail planifié, vous pouvez toujours démarrer le travail à l’aide de l’applet de commande Start-Job ou utiliser le travail planifié désactivé comme modèle.

Disable-ScheduledJob fait partie d’une collection 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

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

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

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

The first command uses the Get-ScheduledJob cmdlet to get the Backup-Archives and Inventory scheduled jobs. A pipeline operator (|) sends the scheduled jobs to the Get-JobTrigger cmdlet, which gets all job triggers of the scheduled jobs. Another pipeline operator sends the job triggers to the **Disable-JobTrigger** cmdlet, which disables them.The first command uses the **Get-ScheduledJob** cmdlet to get the jobs, because its *Name* parameter takes multiple names.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger

The second command displays the results. The command repeats the **Get-ScheduledJob** and **Get-JobTrigger** command. A pipeline operator sends the job triggers to the Format-Table cmdlet, which displays the job triggers in a table. The **Format-Table** command adds a JobName property that displays the value of the Name property of the scheduled job in the JobDefinition property of the job trigger object.
PS C:\> 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

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

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

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

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 tâche à désactiver. 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 Disable-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 les déclencheurs de tâche vers Disable-JobTrigger.

Sorties

None

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

Notes

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