Win32_ScheduledJob classe

  • Article

La classe WMIWin32_ScheduledJob représente un travail créé avec la commande AT.

Notes

La classe Win32_ScheduledJob ne représente pas un travail créé avec l’Assistant Tâche planifiée à partir du Panneau de configuration. Vous ne pouvez pas modifier une tâche créée par WMI dans l’interface utilisateur des tâches planifiées. Pour plus d'informations, consultez la section Notes.

 

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés et les méthodes sont dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

[Dynamic, Provider("CIMWin32"), UUID("{8502C4E0-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("Delete"), AMENDMENT]
class Win32_ScheduledJob : CIM_Job
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime ElapsedTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  datetime TimeSubmitted;
  datetime UntilTime;
  string   Command;
  uint32   DaysOfMonth;
  uint32   DaysOfWeek;
  boolean  InteractWithDesktop;
  uint32   JobId;
  string   JobStatus;
  boolean  RunRepeatedly;
  datetime StartTime;
};

Membres

La classe Win32_ScheduledJob a les types de membres suivants :

Méthodes

La classe Win32_ScheduledJob a ces méthodes.

Méthode Description
Créer Méthode de classe qui envoie un travail au système d’exploitation en vue d’une exécution à une date et une heure ultérieures spécifiées.
Supprimer Méthode de classe qui supprime un travail planifié.

 

Propriétés

La classe Win32_ScheduledJob possède ces propriétés.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

Commande

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de gestion réseau | | AT_INFO Commande « )

Nom de la commande, du programme de traitement par lots ou du fichier binaire (et des arguments de ligne de commande) que le service de planification utilise pour appeler le travail.

Exemple : « defrag/q/f »

DaysOfMonth

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de gestion réseau | | AT_INFO DaysOfMonth »)

Jours du mois où le travail est planifié pour s’exécuter. Si un travail est planifié pour s’exécuter plusieurs jours du mois, ces valeurs peuvent être jointes dans une OR logique. Par exemple, si un travail doit s’exécuter le 1er et le 16 de chaque mois, la valeur de la propriété DaysOfMonth est 1 OR 32768.

1 (1)

1st

2 (2)

2ème

3 (4)

3e

4 (8)

4e

5 (16)

5e

6 (32)

6e

7 (64)

7e

8 (128)

8e

9 (256)

9e

10 (512)

10ème

11 (1024)

11th

12 (2048)

12th

13 (4096)

13th

14 (8192)

14ème

15 (16384)

15ème

16 (32768)

16ème

17 (65536)

17ème

18 (131072)

18ème

19 (262144)

19ème

20 (524288)

20ème

21 (1048576)

21st

22 (2097152)

22nd

23 (4194304)

23rd

24 (8388608)

24ème

25 (16777216)

25ème

26 (33554432)

26ème

27 (67108864)

27ème

28 (134217728)

28ème

29 (268435456)

29ème

30 (536870912)

30ème

31 (1073741824)

31e

DaysOfWeek

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de gestion réseau| | AT_INFO DaysOfWeek »)

Jours de la semaine où un travail est planifié pour s’exécuter. Si un travail est planifié pour s’exécuter plusieurs jours de la semaine, les valeurs peuvent être jointes dans un OR logique. Par exemple, si un travail est planifié pour s’exécuter les lundis, mercredis et vendredis, la valeur de la propriété DaysOfWeek est 1 OU 4 OU 16.

Lundi (1)

Mardi (2)

Mercredi (4)

Jeudi (8)

Vendredi (16)

Samedi (32)

Dimanche (64)

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Description »)

Description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

ElapsedTime

Type de données : datetime

Type d'accès : Lecture seule

Durée d’exécution du travail.

Cette propriété est héritée de CIM_Job.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

Indique quand l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

InteractWithDesktop

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de gestion réseau| | AT_INFO Drapeaux|JOB_NONINTERACTIVE »)

Le travail spécifié est interactif, ce qui signifie qu’un utilisateur peut fournir une entrée à un travail planifié pendant son exécution.

JobId

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : Key, MappingStrings (« Win32API| Structures de gestion réseau| | AT_ENUM JobId »)

Identification du numéro du travail. Il est utilisé par les méthodes comme handle pour un travail planifié sur cet ordinateur.

JobStatus

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Override (« JobStatus »), MappingStrings (« Win32API| Structures de gestion réseau| | AT_ENUM Drapeaux|JOB_EXEC_ERROR »)

État de l’exécution de la dernière fois que ce travail a été planifié pour s’exécuter.

Réussite (« Réussite »)

Échec (« Échec »)

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Name »)

Étiquette par laquelle l’objet est connu. En cas de sous-classe, cette propriété peut être remplacée pour être une propriété de clé.

Cette propriété est héritée de CIM_ManagedSystemElement.

Notifier

Type de données : chaîne

Type d'accès : Lecture seule

L’utilisateur est averti en cas d’achèvement ou d’échec du travail.

Cette propriété est héritée de CIM_Job.

Propriétaire

Type de données : chaîne

Type d'accès : Lecture seule

Utilisateur qui a envoyé le travail.

Cette propriété est héritée de CIM_Job.

Priorité

Type de données : uint32

Type d'accès : Lecture seule

Importance de l’exécution d’un travail.

Cette propriété est héritée de CIM_Job.

Exécuterrepeatedly

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de gestion réseau| | AT_INFO Drapeaux|JOB_RUN_PERIODICALLY »)

Le travail planifié s’exécute à plusieurs reprises les jours où le travail est planifié. Si la valeur est False, le travail est exécuté une seule fois.

StartTime

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : Override (« StartTime »), MappingStrings (« Win32API| Structures de gestion réseau| | AT_ENUM JobTime »)

Heure UTC d’exécution du travail, sous la forme « AAAAMMDDHHMMSS. MMMMMM(+-)OOO », où « AAAAMMJJ » doit être remplacé par « ******** ». Le remplacement est nécessaire, car le service de planification n’autorise la configuration des travaux qu’à exécuter une seule fois, ou à s’exécuter un jour du mois ou de la semaine. Un travail ne peut pas être exécuté à une date spécifique.

La section « (+-)OOO » de la valeur de la propriété StartTime est le biais actuel pour la traduction d’heure locale. Le biais est la différence entre l’heure UTC et l’heure locale. Pour calculer le biais de votre fuseau horaire, multipliez le nombre d’heures pendant lesquelles votre fuseau horaire est en avance ou derrière l’heure moyenne de Greenwich (GMT) par 60 (utilisez un nombre positif pour le nombre d’heures si votre fuseau horaire est en avance sur GMT et un nombre négatif si votre fuseau horaire est en retard GMT). Ajoutez 60 supplémentaires à votre calcul si votre fuseau horaire utilise l’heure d’été. Par exemple, le fuseau horaire standard du Pacifique est de huit heures par rapport à GMT. Par conséquent, le biais est égal à -420 (-8 * 60 + 60) lorsque l’heure d’été est en cours d’utilisation et à -480 (-8 * 60) lorsque l’heure d’été n’est pas utilisée. Vous pouvez également déterminer la valeur du biais en interrogeant la propriété bias de la classe Win32_TimeZone .

Par exemple : « *********123000.00000-420 » spécifie 14,30 (14:30) PST avec l’heure d’été en vigueur.

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Chaîne qui indique la status actuelle de l’objet. Il est possible de définir des status opérationnels et non opérationnels. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un disque dur smart).

Les status non opérationnelles peuvent inclure « Error », « Starting », « Stopping » et « Service ». « Service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Dégradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec du prédé (« Échec anticipé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

TimeSubmitted

Type de données : datetime

Type d'accès : Lecture seule

Heure à laquelle le travail a été soumis.

Cette propriété est héritée de CIM_Job.

UntilTime

Type de données : datetime

Type d'accès : Lecture seule

Heure à laquelle le travail n’est pas valide ou doit être arrêté.

Cette propriété est héritée de CIM_Job.

Notes

Chaque travail planifié par rapport au service de planification est stocké de manière permanente (le planificateur peut démarrer un travail après un redémarrage) et est exécuté à l’heure et au jour spécifiés de la semaine ou du mois. Si l’ordinateur n’est pas actif ou si le service planifié n’est pas en cours d’exécution à l’heure de travail spécifiée, le service de planification exécute le travail spécifié le jour suivant à l’heure spécifiée.

Les travaux sont planifiés en fonction du temps universel coordonné (UTC) avec décalage de biais par rapport à l’heure moyenne de Greenwich (GMT), ce qui signifie qu’un travail peut être spécifié à l’aide de n’importe quel fuseau horaire. La classe Win32_ScheduledJob retourne l’heure locale avec décalage UTC lors de l’énumération d’un objet et convertit en heure locale lors de la création de nouveaux travaux. Par exemple, un travail spécifié pour s’exécuter sur un ordinateur à Boston à 22 h 30 heure PST du lundi sera planifié pour s’exécuter localement à 1 h 30 mardi EST.

Notes

Un client doit tenir compte de l’utilisation de l’heure d’été sur l’ordinateur local et, le cas échéant, soustraire un biais de 60 minutes du décalage UTC.

 

La classe Win32_ScheduledJob est dérivée de CIM_Job. Vous devez être membre du groupe Administrateurs pour créer un travail planifié à l’aide de cette classe.

La classe Win32_ScheduledJob utilise en interne le protocole AT, qui est lié à la dépréciation en commençant par Windows 8 et Windows Server 2012. Dans une première étape, le protocole AT est désactivé par défaut. Si le protocole est désactivé, par exemple, l’appel de la méthode Create sur un objet Win32_ScheduledJob échoue avec 0x8 d’erreur. Vous pouvez réactiver le protocole AT en ajoutant l’entrée de Registre suivante :

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Schedule\Configuration 
Name: EnableAt 
Type: REG_DWORD
Value: 1

Vous devrez peut-être redémarrer l’ordinateur pour que le paramètre soit effectif.

Étant donné que Win32_ScheduledJob est basé sur l’API Win32 NetScheduleJobGetInfo , vous ne pouvez pas utiliser cette classe conjointement avec le Planificateur de tâches. Si vous souhaitez utiliser le Planificateur de tâches, utilisez l’API Planificateur de tâches. Pour plus d’informations, consultez référence du planificateur de tâches.

Exemples

L’exemple de code VBScript suivant planifie Notepad.exe pour s’exécuter de manière interactive à 1:25 à l’heure de l’ordinateur local tous les mercredis.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set objNewJob = objWMIService.Get("Win32_ScheduledJob")
errJobCreated = objNewJob.Create("Notepad.exe", "********012500.000000-420", True , 4, , True, JobId) 
If errJobCreated <> 0 Then
Wscript.Echo "Error on task creation"
Else
Wscript.Echo "Task created"
End If

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows Vista
Serveur minimal pris en charge
 Windows Server 2008
Espace de noms
 Racine\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Voir aussi

CIM_Job

Classes du système d’exploitation

Tâches WMI : tâches planifiées