Créer une méthode de la classe Win32_ScheduledJob

La méthode declasse CreateWMI envoie un travail à un système d’exploitation pour l’exécution à une heure et une date spécifiées à l’avenir. Cette méthode nécessite que le service de planification soit démarré sur l’ordinateur auquel le travail est envoyé.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.

Syntaxe

uint32 Create(
  [in]           string   Command,
  [in]           datetime StartTime,
  [in, optional] boolean  RunRepeatedly,
  [in, optional] uint32   DaysOfWeek,
  [in, optional] uint32   DaysOfMonth,
  [in, optional] boolean  InteractWithDesktop,
  [out]          uint32   JobId
);

Paramètres

Commande [in]

Nom de la commande, du programme batch ou du fichier binaire et des paramètres de ligne de commande que le service de planification utilise pour appeler le travail.

Exemple : « defrag /q /f ».

StartTime [in]

Temps universel coordonné (UTC) pour exécuter un travail. Le formulaire doit être : « YYYYMMDDHHMMSSS. MMMMMM(+-)OOO », où « AAAYYMMDD » doit être remplacé par « ****** ». Par exemple : « ***1430000.00000-420 » spécifie 14.30 (2:30 P.M.) PST avec temps d’été en vigueur.

La section « (+-)OOO » de la valeur de la propriété StartTime est le biais actuel de la traduction de temps local. 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 que 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 devant GMT et un nombre négatif si votre fuseau horaire est derrière GMT). Ajoutez un autre 60 à votre calcul si votre fuseau horaire utilise l’heure d’été. Par exemple, le fuseau horaire standard pacifique est huit heures derrière GMT, par conséquent, le biais est égal à -420 (-8 * 60 + 60) lorsque l’heure d’été est utilisée 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é de biais de la classe Win32_TimeZone .

RunRepeatedly [in, facultatif]

Si la valeur est True, un travail planifié s’exécute à plusieurs reprises sur des jours spécifiques. La valeur par défaut est False.

DaysOfWeek [in, facultatif]

Jours de la semaine lors de l’exécution d’un travail ; utilisé uniquement lorsque le paramètre RunRepeatedly a la valeur True. Pour planifier un travail pour plusieurs jours de la semaine, joignez les valeurs appropriées dans une or logique. Par exemple, pour planifier un travail pour mardis et vendredis, la valeur de DaysOfWeek est 2 OR 16.

Lundi (1)

Mardi (2)

Mercredi (4)

Jeudi (8)

Vendredi (16)

Samedi (32)

Dimanche (64)

DaysOfMonth [in, facultatif]

Jours du mois lors de l’exécution d’un travail ; utilisé uniquement lorsque le paramètre RunRepeatedly a la valeur True.

1 (1)

Jour 1 d’un mois

2 (2)

Jour 2 d’un mois

3 (4)

Jour 3 d’un mois

4 (8)

Jour 4 d’un mois

5 (16)

Jour 5 d’un mois

6 (32)

Jour 6 d’un mois

7 (64)

Jour 7 d’un mois

8 (128)

Jour 8 d’un mois

9 (256)

Jour 9 d’un mois

10 (512)

Jour 10 d’un mois

11 (1024)

Jour 11 d’un mois

12 (2048)

Jour 12 d’un mois

13 (4096)

Jour 13 d’un mois

14 (8192)

Jour 14 d’un mois

15 (16384)

Jour 15 d’un mois

16 (32768)

Jour 16 d’un mois

17 (65536)

Jour 17 d’un mois

18 (131072)

Jour 18 d’un mois

19 (262144)

Jour 19 d’un mois

20 (524288)

Jour 20 d’un mois

21 (1048576)

Jour 21 d’un mois

22 (2097152)

Jour 22 d’un mois

23 (4194304)

Jour 23 d’un mois

24 (8388608)

Jour 24 d’un mois

25 (16777216)

Jour 25 d’un mois

26 (33554432)

Jour 26 d’un mois

27 (67108864)

Jour 27 d’un mois

28 (134217728)

Jour 28 d’un mois

29 (268435456)

Jour 29 d’un mois

30 (536870912)

Jour 30 d’un mois

31 (1073741824)

Jour 31 d’un mois

InteractWithDesktop [in, facultatif]

Si la valeur est True, le travail spécifié doit être interactif, ce qui signifie qu’un utilisateur peut donner une entrée à un travail planifié pendant l’exécution du travail. La valeur par défaut est False.

JobId [out]

Numéro d’identificateur d’un travail. Ce paramètre est un handle pour un travail planifié sur un ordinateur.

Valeur retournée

Retourne une valeur de 0 (zéro) en cas de réussite et un autre nombre pour indiquer une erreur. Pour obtenir des codes d’erreur supplémentaires, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour obtenir des valeurs HRESULT générales, consultez Codes d’erreur système.

Opération réussie

0

La demande est acceptée.

Non pris en charge

1

La demande n'est pas prise en charge.

Accès refusé

2

L’utilisateur n’a pas l’accès nécessaire.

Échec inconnu

8

Processus interactif.

Chemin introuvable

9

Le chemin d’accès au répertoire du fichier exécutable du service est introuvable.

Paramètre non valide

21

Les paramètres non valides ont été passés au service.

Service non démarré

22

Le compte sous lequel ce service s’exécute n’est pas valide ou ne dispose pas des autorisations nécessaires pour exécuter le service.

Autres

23 4294967295

Notes

Si votre travail planifié démarre un programme interactif tel que Bloc-notes, la propriété InteractWithDeskto doit être définie sur True ou l’écran du programme n’est pas visible. Le processus apparaît toujours dans le Gestionnaire des tâches même s’il n’apparaît pas sur l’écran.

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

Classes du système d’exploitation

Win32_ScheduledJob