Create-Methode der Win32_ScheduledJob-Klasse
Die CreateWMI-Klassenmethode sendet einen Auftrag an ein Betriebssystem zur Ausführung zu einem bestimmten Zeitpunkt und datum in der Zukunft. Diese Methode erfordert, dass der Zeitplandienst auf dem Computer gestartet wird, an den der Auftrag übermittelt wird.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
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
);
Parameter
-
Befehl [in]
-
Name der Befehls-, Batch- oder Binärdatei- und Befehlszeilenparameter, die der Zeitplandienst zum Aufrufen des Auftrags verwendet.
Beispiel: "defrag /q /f".
-
StartTime [in]
-
Koordinierte Weltzeit (UTC)-Zeit zum Ausführen eines Auftrags. Das Formular muss folgendes sein: "JJJJMMDDHMMMMSS. MMMMMM(+-)OOO", wobei "JJJJMMD" durch "********" ersetzt werden muss. Beispiel: "****143000.000000-420" gibt 14.30 (14:30 Uhr) an. PST mit Sommerzeit in Kraft.
Der Abschnitt "(+-)OOO" des StartTime-Eigenschaftswerts ist die aktuelle Verzerrung für die Lokale Zeitübersetzung. Die Verzerrung ist der Unterschied zwischen der UTC-Zeit und der Ortszeit. Um die Verzerrung für Ihre Zeitzone zu berechnen, multiplizieren Sie die Anzahl der Stunden, die ihre Zeitzone vor oder hinter Greenwich Mean Time (GMT) befindet, mit 60 (verwenden Sie eine positive Zahl für die Anzahl der Stunden, wenn Ihre Zeitzone vor GMT liegt, und eine negative Zahl, wenn Ihre Zeitzone hinter GMT liegt). Fügen Sie ihrer Berechnung weitere 60 hinzu, wenn Ihre Zeitzone die Sommerzeit verwendet. Beispielsweise liegt die Pacific Standard Time Zone acht Stunden hinter GMT, daher ist die Verzerrung gleich -420 (-8 * 60 + 60), wenn die Sommerzeit verwendet wird, und -480 (-8 * 60), wenn die Sommerzeit nicht verwendet wird. Sie können auch den Wert der Verzerrung bestimmen, indem Sie die Bias-Eigenschaft der Win32_TimeZone-Klasse abfragen.
-
RunRepeatedly [in, optional]
-
Wenn True, wird ein geplanter Auftrag wiederholt an bestimmten Tagen ausgeführt. Der Standardwert ist False.
-
DaysOfWeek [in, optional]
-
Wochentage, an denen die Ausführung eines Auftrags geplant ist; wird nur verwendet, wenn der RunRepeatedly-ParameterTrue ist. Um einen Auftrag für mehr als einen Tag der Woche zu planen, fügen Sie die entsprechenden Werte in ein logisches OR ein. Wenn Sie beispielsweise einen Auftrag für Dienstag und Freitag planen möchten, beträgt der Wert von DaysOfWeek 2 ODER 16.
-
Montag (1)
-
Dienstag (2)
-
Mittwoch (4)
-
Donnerstag (8)
-
Freitag (16)
-
Samstag (32)
-
Sonntag (64)
DaysOfMonth [in, optional]
Tage des Monats, in dem die Ausführung eines Auftrags geplant ist; wird nur verwendet, wenn der RunRepeatedly-ParameterTrue ist.
1 (1)
Tag 1 eines Monats
2 (2)
Tag 2 eines Monats
3 (4)
Tag 3 eines Monats
4 (8)
Tag 4 eines Monats
5 (16)
Tag 5 eines Monats
6 (32)
Tag 6 eines Monats
7 (64)
Tag 7 eines Monats
8 (128)
Tag 8 eines Monats
9 (256)
Tag 9 eines Monats
10 (512)
Tag 10 eines Monats
11 (1024)
Tag 11 eines Monats
12 (2048)
Tag 12 eines Monats
13 (4096)
Tag 13 eines Monats
14 (8192)
Tag 14 eines Monats
15 (16384)
Tag 15 eines Monats
16 (32768)
Tag 16 eines Monats
17 (65536)
Tag 17 eines Monats
18 (131072)
Tag 18 eines Monats
19 (262144)
Tag 19 eines Monats
20 (524288)
Tag 20 eines Monats
21 (1048576)
Tag 21 eines Monats
22 (2097152)
Tag 22 eines Monats
23 (4194304)
Tag 23 eines Monats
24 (8388608)
Tag 24 eines Monats
25 (16777216)
Tag 25 eines Monats
26 (33554432)
Tag 26 eines Monats
27 (67108864)
Tag 27 eines Monats
28 (134217728)
Tag 28 eines Monats
29 (268435456)
Tag 29 eines Monats
30 (536870912)
Tag 30 eines Monats
31 (1073741824)
Tag 31 eines Monats
InteractWithDesktop [in, optional]
Bei True sollte der angegebene Auftrag interaktiv sein. Dies bedeutet, dass ein Benutzer während der Ausführung des Auftrags Eingaben für einen geplanten Auftrag geben kann. Der Standardwert ist False.
JobId [out]
Bezeichnernummer eines Auftrags. Dieser Parameter ist ein Handle für einen Auftrag, der auf einem Computer geplant wird.
Rückgabewert
Gibt bei erfolgreicher Ausführung den Wert 0 (Null) und eine andere Zahl zurück, um einen Fehler anzuzeigen. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
Erfolgreicher Abschluss
-
0
Die Anforderung wird akzeptiert.
-
Nicht unterstützt
-
1
Die Anforderung wird nicht unterstützt.
-
Zugriff verweigert
-
2
Der Benutzer hat nicht den erforderlichen Zugriff.
-
Unbekannter Fehler
-
8
Interaktiver Prozess.
-
Der Pfad wurde nicht gefunden
-
9
Der Verzeichnispfad zur ausführbaren Datei des Diensts wurde nicht gefunden.
-
Ungültiger Parameter
-
21
Ungültige Parameter wurden an den Dienst übergeben.
-
Dienst nicht gestartet
-
22
Das Konto, unter dem dieser Dienst ausgeführt wird, ist ungültig oder verfügt nicht über die Berechtigungen zum Ausführen des Diensts.
-
Andere
-
23 4294967295
Bemerkungen
Wenn Ihr geplanter Auftrag ein interaktives Programm wie Editor startet, muss die InteractWithDeskto-Eigenschaft auf True festgelegt werden , da der Bildschirm des Programms nicht sichtbar ist. Der Prozess wird weiterhin im Task-Manager angezeigt, auch wenn er nicht auf dem Bildschirm angezeigt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|