Erstellen einer Methode der Win32_ScheduledJob Klasse

Die CreateWMI-Klassenmethode sendet einen Auftrag an ein Betriebssystem für die Ausführung zu einem bestimmten Zeitpunkt und datum in zukunft. Diese Methode erfordert, dass der Zeitplandienst auf dem Computer gestartet wird, an den der Auftrag übermittelt wird.

In diesem Thema wird die Syntax "Managed Object Format" (MOF) 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 des Befehls, des Batchprogramms oder der Binären Datei und der Befehlszeilenparameter, die der Zeitplandienst zum Aufrufen des Auftrags verwendet.

Beispiel: "defrag /q /f".

StartTime [in]

Koordinierte Universal Time (UTC)-Zeit zum Ausführen eines Auftrags. Das Formular muss sein: "YYYYMMDDHHMMSS. MMMMMM(+-)OOO", wo "YYYYMMDDD" durch "********" ersetzt werden muss. Beispiel: "********143000.00000-420" gibt 14.30 (2:30 P.M.) 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 lokalen Uhrzeit. Um die Verzerrung für Ihre Zeitzone zu berechnen, multiplizieren Sie die Anzahl der Stunden, die Ihre Zeitzone voraus oder hinter Greenwich Mean Time (GMT) um 60 (verwenden Sie eine positive Zahl für die Anzahl der Stunden, wenn Ihre Zeitzone vor GMT ist und eine negative Zahl, wenn Ihre Zeitzone hinter GMT liegt). Fügen Sie Ihrer Berechnung eine zusätzliche 60 hinzu, wenn Ihre Zeitzone Die Sommerzeit verwendet. Beispielsweise ist die Pacific Standard Time Zone acht Stunden hinter GMT, daher ist die Verzerrung gleich -420 (-8 * 60 + 60) wenn Die Sommersparzeit verwendet wird und -480 (-8 * 60) verwendet wird, wenn Die Sommersparzeit 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" ausgeführt wird, wird ein geplanter Auftrag wiederholt an bestimmten Tagen ausgeführt. Der Standardwert ist False.

DaysOfWeek [in, optional]

Tage der Woche, wenn ein Auftrag ausgeführt werden soll; Wird nur verwendet, wenn der RunRepeatedly-Parameter"True" ist. Um einen Auftrag für mehr als einen Tag der Woche zu planen, verknüpfen Sie die entsprechenden Werte in einem logischen OR. Um beispielsweise einen Auftrag für Dienstags und Freitags zu planen, sind die Werte von DaysOfWeek 2 OR 16.

Montag (1)

Dienstag (2)

Mittwoch (4)

Donnerstag (8)

Freitag (16)

Samstag (32)

Sonntag (64)

DaysOfMonth [in, optional]

Tage des Monats, an denen ein Auftrag ausgeführt werden soll; Wird nur verwendet, wenn der RunRepeatedly-Parameter"True" 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]

Wenn True, sollte der angegebene Auftrag interaktiv sein, was bedeutet, dass ein Benutzer Eingaben zu einem geplanten Auftrag geben kann, während der Auftrag ausgeführt wird. 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 einen Wert von 0 (Null) beim Erfolgreichen zurück, und eine andere Zahl, um einen Fehler anzugeben. 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 verfügt nicht über den erforderlichen Zugriff.

Unbekannter Fehler

8

Interaktiver Prozess.

Pfad wurde nicht gefunden

9

Der Verzeichnispfad zur ausführbaren Dienstdatei kann nicht gefunden werden.

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 fehlt 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, oder der Bildschirm des Programms ist nicht sichtbar. Der Prozess wird weiterhin im Task-Manager angezeigt, auch wenn er nicht auf dem Bildschirm angezeigt wird.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Weitere Informationen

Betriebssystemklassen

Win32_ScheduledJob