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 |
|
| DLL |
|