Partager via

Get-ScheduledJob

  • Référence
Module:
PSScheduledJob

Obtient les tâches planifiées sur l'ordinateur local.

Syntaxe

Get-ScheduledJob
   [[-Id] <Int32[]>]
   [<CommonParameters>]
Get-ScheduledJob
   [-Name] <String[]>
   [<CommonParameters>]

Description

L’applet Get-ScheduledJob de commande obtient des travaux planifiés sur l’ordinateur local. Get-ScheduledJob obtient uniquement les travaux planifiés créés par l’utilisateur actuel à l’aide de l’applet de Register-ScheduledJob commande.

Bien que les travaux créés à l’aide de l’applet Register-ScheduledJob de commande apparaissent dans le Planificateur de tâches, Get-ScheduledJob il n’obtient que des travaux planifiés. Elle n'obtient pas les tâches planifiées créées dans le Planificateur de tâches.

Sans paramètres, Get-ScheduledJob obtient tous les travaux planifiés sur l’ordinateur. Vous pouvez utiliser les paramètres de l’obtention de Get-ScheduledJob travaux planifiés par ID ou par nom et les examiner ou les diriger vers d’autres applets de commande.

Get-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 : Obtenir tous les travaux planifiés

Cet exemple obtient tous les travaux planifiés sur l’ordinateur local.

Get-ScheduledJob

Exemple 2 : Obtenir des travaux planifiés par nom

Cet exemple obtient tous les travaux planifiés sur l’ordinateur qui ont des noms qui incluent la sauvegarde ou l’archive. Ce format de commande vous permet de rechercher des tâches spécifiques.

Get-ScheduledJob -Name *Backup*, *Archive*

Exemple 3 : Obtenir des travaux planifiés sur des ordinateurs distants

Cet exemple obtient tous les travaux planifiés sur les ordinateurs répertoriés dans un fichier texte.

Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

La commande utilise l’applet Invoke-Command de commande pour exécuter une Get-ScheduleJob commande sur chaque ordinateur.

Exemple 4 : Diriger des travaux planifiés vers d’autres applets de commande

Cet exemple obtient les déclencheurs de travail des travaux planifiés spécifiés

Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Il utilise l’applet Get-ScheduledJob de commande pour obtenir les travaux planifiés et les canaliser vers l’applet Get-JobTrigger de commande pour obtenir les déclencheurs de travail des travaux planifiés.

Paramètres

-Id

Obtient uniquement les tâches planifiées avec le numéro d'identification (ID) spécifié. Entrez un ou plusieurs ID de tâches planifiées sur l'ordinateur. Par défaut, Get-ScheduledJob obtient tous les travaux planifiés sur l’ordinateur.

Type:Int32[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Obtient uniquement les tâches planifiées avec les noms spécifiés. Entrez un ou plusieurs noms de tâches planifiées sur l'ordinateur. Les caractères génériques sont pris en charge. Par défaut, Get-ScheduledJob obtient tous les travaux planifiés sur l’ordinateur.

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

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

ScheduledJobDefinition

Cette applet de commande retourne la définition d’un travail planifié.

Notes

  • Chaque travail planifié est enregistré dans un sous-répertoire du $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs répertoire sur l’ordinateur local. Le sous-répertoire est nommé pour la tâche planifiée et contient le fichier XML pour cette tâche et les enregistrements de son historique d'exécution. Pour plus d’informations sur les travaux planifiés sur le disque, consultez about_Scheduled_Jobs_Advanced.
  • Les travaux planifiés que vous créez dans Windows PowerShell s’affichent dans le Planificateur de tâches dans le dossier Planificateur de Library\Microsoft\Windows\PowerShell\ScheduledJobs tâches. Vous pouvez utiliser le Planificateur de tâches pour afficher et modifier la tâche planifiée.
  • Vous pouvez utiliser le planificateur de tâches, l’outil SchTasks.exe en ligne de commande et les applets de commande du planificateur de tâches pour gérer les travaux planifiés que vous créez avec les applets de commande De travail planifiées. Toutefois, vous ne pouvez pas utiliser les applets de commande de la tâche planifiée pour gérer les tâches que vous créez dans le Planificateur de tâches.