Partager via

Remove-JobTrigger

  • Référence
Module:
PSScheduledJob

Supprimez les déclencheurs de travail des travaux planifiés.

Syntaxe

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

Description

L’applet Remove-JobTrigger de commande supprime les déclencheurs de travaux planifiés.

Un déclencheur de travail définit une planification ou des conditions périodiques pour démarrer un travail planifié. Pour gérer les déclencheurs de travail, utilisez les applets de commande New-JobTrigger, Add-JobTrigger, Set-JobTrigger et Set-ScheduledJob cmdlets.

Utilisez les paramètres Name, ID ou InputObject pour Remove-JobTrigger identifier les travaux planifiés à partir desquels les déclencheurs sont supprimés. Utilisez le paramètre TriggerID pour identifier les déclencheurs de travail à supprimer. Par défaut, Remove-JobTrigger supprime tous les déclencheurs de travail d’un travail planifié.

Remove-JobTrigger 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 : Supprimer tous les déclencheurs de travail

Remove-JobTrigger -Name "Test*"

Cette commande supprime tous les déclencheurs de travail du travail planifié qui ont des noms qui commencent par Test.

Exemple 2 : Supprimer les déclencheurs de travail sélectionnés

Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Cette commande supprime uniquement le troisième déclencheur (ID = 3) de la tâche planifiée BackupArchive.

Exemple 3 : Supprimer les déclencheurs de travail AtStartup de tous les travaux planifiés

function Delete-AtStartup
{
    Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.Frequency -eq "AtStartup"} | ForEach-Object { Remove-JobTrigger -InputObject $_.JobDefinition -TriggerID $_.ID}
}

Cette fonction supprime tous les déclencheurs de tâche AtStartup de toutes les tâches sur l'ordinateur local. Pour utiliser la fonction, exécutez la fonction dans votre session, puis tapez Delete-AtStartup.

La Delete-AtStartup fonction contient une seule commande. 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, qui obtient tous les déclencheurs de travail de chacun des travaux planifiés. Un opérateur de pipeline envoie les déclencheurs de travail à l’applet Where-Object de commande, qui sélectionne les déclencheurs de travail où la valeur de la propriété Frequency du déclencheur de travail est égale à AtStartup.

Les objets JobTrigger ont une propriété JobDefinition qui contient le travail planifié qu’ils déclenchent. Le reste de la commande utilise cette précieuse fonctionnalité.

Un opérateur de pipeline envoie les déclencheurs de travail AtStartup à l’applet ForEach-Object de commande, qui exécute une Remove-JobTrigger commande sur chaque déclencheur AtStartup. La valeur du paramètre InputObject de Remove-JobTrigger est la tâche planifiée dans la propriété JobDefinition du déclencheur de travail. La valeur du paramètre TriggerID est l’identificateur dans la propriété ID du déclencheur de travail.

Exemple 4 : Supprimer un déclencheur de travail à partir d’un travail planifié à distance

Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

Cette commande supprime le premier déclencheur de tâche de la tâche Inventory sur l'ordinateur Server01.

La commande utilise l’applet Invoke-Command de commande pour exécuter l’applet Remove-JobTrigger de commande sur l’ordinateur Server01. L’applet Remove-JobTrigger de commande utilise le paramètre ID pour identifier le travail planifié d’inventaire et le paramètre TriggerID pour spécifier le premier déclencheur. Le paramètre ID est particulièrement utile lorsque plusieurs travaux planifiés ont les mêmes noms ou similaires.

Paramètres

-Id

Spécifie les numéros d'identification des tâches planifiées. Remove-JobTrigger supprime les déclencheurs de travail des travaux planifiés spécifiés.

Pour obtenir le numéro d’identification des travaux planifiés sur l’ordinateur local ou un ordinateur distant, utilisez l’applet Get-ScheduledJob de commande.

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 les tâches planifiées. Entrez une variable qui contient des objets ScheduledJob ou tapez une commande ou une expression qui obtient des objets ScheduledJob , comme une Get-ScheduledJob commande. Vous pouvez également diriger des objets ScheduledJob vers Remove-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 les noms des tâches planifiées. Remove-JobTrigger supprime les déclencheurs de travail des travaux planifiés spécifiés. 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 Get-ScheduledJob de commande.

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

Supprime uniquement les déclencheurs de tâche spécifiés. Par défaut, Remove-JobTrigger supprime tous les déclencheurs des travaux planifiés. Utilisez ce paramètre quand les tâches planifiées ont plusieurs déclencheurs de tâche.

Entrez les ID d'un ou de plusieurs déclencheurs de tâche d'une tâche planifiée. Si vous spécifiez plusieurs travaux planifiés, Remove-JobTrigger supprime le déclencheur de travail avec l’ID spécifié de tous les travaux planifiés.

Type:Int32[]
Position:Named
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é vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.