Partager via

Get-ScheduledJob

  • Référence
Module:
PSScheduledJob

Obtient des travaux planifiés sur l’ordinateur local.

Syntaxe

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

Description

L’applet de commande Get-ScheduledJob 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 commande Register-ScheduledJob.

Bien que les travaux créés à l’aide de l’applet de commande Register-ScheduledJob apparaissent dans le Planificateur de tâches, Get-ScheduledJob obtient uniquement des travaux planifiés. Il 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 Get-ScheduledJob pour obtenir des travaux planifiés par ID ou par nom et les examiner ou les diriger vers d’autres applets de commande.

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

PS C:\> Get-ScheduledJob

Cette commande obtient tous les travaux planifiés sur l’ordinateur local.

Exemple 2 : Obtenir des travaux planifiés par nom

PS C:\> Get-ScheduledJob -Name *Backup*, *Archive*

Cette commande 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 travaux particuliers.

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

PS C:\> Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

Cette commande obtient tous les travaux planifiés sur les ordinateurs répertoriés dans le fichier Servers.txt. La commande utilise l’applet de commande Invoke-Command pour exécuter une commande Get-ScheduleJob sur chaque ordinateur.

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

PS C:\> Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Cette commande obtient les déclencheurs de travail des travaux Planifiés DailyBackup et WeeklyBackup. Il utilise l’applet de commande Get-ScheduledJob pour obtenir les travaux planifiés et l’applet de commande Get-JobTrigger pour obtenir les déclencheurs de travail des travaux planifiés.

Paramètres

-Id

Obtient uniquement les travaux planifiés avec le numéro d’identification (ID) spécifié. Entrez un ou plusieurs ID de travaux planifiés 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:All jobs
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Obtient uniquement les travaux planifiés avec les noms spécifiés. Entrez un ou plusieurs noms de travaux planifiés 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:All jobs
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 l’entrée vers Get-ScheduledJob .

Sorties

ScheduledJobDefinition

Notes

  • Chaque travail planifié est enregistré dans un sous-répertoire du répertoire $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs sur l’ordinateur local. Le sous-répertoire est nommé pour le travail planifié et contient le fichier XML pour le travail planifié 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 Bibliothèque du planificateur de tâches\Microsoft\Windows\PowerShell\ScheduledJobs. Vous pouvez utiliser le planificateur de tâches pour afficher et modifier le travail planifié.
  • Vous pouvez utiliser le Planificateur de tâches, l’outil en ligne de commande SchTasks.exe 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 travail planifiées pour gérer les tâches que vous créez dans le Planificateur de tâches.