Win32_ScheduledJob classe

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

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
• Propriétés

Méthodes

La classe Win32_ScheduledJob a ces méthodes.

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

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.

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

Voir aussi

CIM_Job

Classes du système d’exploitation

Tâches WMI : tâches planifiées