Créer une méthode de la classe Win32_ScheduledJob
La méthode Créer une classe WMI envoie un travail à un système d’exploitation en vue d’une 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]
-
Heure UTC (Temps universel coordonné) pour exécuter un travail. Le formulaire doit être : « AAAAMMDDHHMMSSS. MMMMMM(+-)OOO », où « AAAAMMJJ » doit être remplacé par « ********** ». Par exemple : « *******143000.000000-420 » spécifie 14.30 (14h30) PST avec heure d’été en vigueur.
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 arrière-plan). Ajoutez 60 autres à 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 .
-
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 où un travail est planifié pour s’exécuter ; utilisé uniquement lorsque le paramètre RunRepeatedly a la valeur True. Pour planifier un travail pendant plusieurs jours de la semaine, joignez les valeurs appropriées dans une OR logique. Par exemple, pour planifier un travail pour les mardis et vendredis, la valeur de DaysOfWeek est 2 OU 16.
-
Lundi (1)
-
Mardi (2)
-
Mercredi (4)
-
Jeudi (8)
-
Vendredi (16)
-
Samedi (32)
-
Dimanche (64)
DaysOfMonth [in, facultatif]
Jours du mois où une tâche est planifiée pour s’exécuter ; 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 fournir une entrée à un travail planifié pendant l’exécution du travail. La valeur par défaut est False.
JobId [out]
Numéro d’identification 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 nombre différent pour indiquer une erreur. Pour obtenir des codes d’erreur supplémentaires, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.
-
Réussite
-
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 d'accès introuvable
-
9
Le chemin d’accès au répertoire du fichier exécutable de service est introuvable.
-
Paramètre non valide
-
21
Des 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 n’a pas les autorisations nécessaires pour exécuter le service.
-
Autres
-
23 4294967295
Notes
Si votre travail planifié démarre un programme interactif tel que le 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 à 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 |
|