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[]>]
      [-Name] <String[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Id] <Int32[]>
      [<CommonParameters>]

Description

L’applet de commande Remove-JobTrigger supprime les déclencheurs de travail des 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.

Utilisez les paramètres Name, IDou InputObject des paramètres de Remove-JobTrigger pour 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 une collection d’applets de commande de planification de travaux dans le module PSScheduledJob inclus dans Windows PowerShell.

Pour plus d’informations sur les travaux planifiés, consultez les rubriques À propos du 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

PS C:\> 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

PS C:\> Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Cette commande supprime uniquement le troisième déclencheur (ID = 3) du travail planifié BackupArchive.

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

PS C:\> 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 travail AtStartup de tous les travaux sur l’ordinateur local. Pour utiliser la fonction, exécutez la fonction dans votre session, puis tapez Delete-AtStartup.

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

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

Un opérateur de pipeline envoie les déclencheurs de travail AtStartup à l’applet de commande ForEach-Object, qui exécute une commande Remove-JobTrigger 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

PS C:\> Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

Cette commande supprime le premier déclencheur de travail du travail d’inventaire sur l’ordinateur Server01.

La commande utilise l’applet de commande Invoke-Command pour exécuter l’applet de commande Remove-JobTrigger sur l’ordinateur Server01. L’applet de commande Remove-JobTrigger utilise le paramètre ID de pour identifier le travail planifié d’inventaire et le paramètre TriggerID pour spécifier le premier déclencheur. L’ID paramètre 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 travaux planifiés. 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 de commande Get-ScheduledJob.

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 travaux planifiés. Entrez une variable qui contient objets ScheduledJob ou tapez une commande ou une expression qui obtient objets ScheduledJob, tels qu’une commande Get-ScheduledJob. Vous pouvez également diriger 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 travaux planifiés. 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 de commande Get-ScheduledJob.

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 travail spécifiés. Par défaut, Remove-JobTrigger supprime tous les déclencheurs des travaux planifiés. Utilisez ce paramètre lorsque les travaux planifiés ont plusieurs déclencheurs de travail.

Entrez les ID de déclencheur d’un ou plusieurs déclencheurs de travail d’un travail planifié. 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:All triggers
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

ScheduledJobDefinition

Vous pouvez diriger les travaux planifiés vers l’applet de commande Remove-JobTrigger .

Sorties

None

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