Create-Methode der Win32 _ ScheduledJob-Klasse

Die Methode WMI-Klasse erstellen übermittelt einen Auftrag zur Ausführung zu einem bestimmten Zeitpunkt und einem bestimmten Datum in der Zukunft an ein Betriebssystem. Diese Methode erfordert, dass der Zeitplandienst auf dem Computer gestartet wird, an den der Auftrag übermittelt wird.

In diesem Thema wird Managed Object Format (MOF)-Syntax 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]

Der Name des Befehls, des Batchprogramms oder der Binärdatei sowie der Befehlszeilenparameter, die der Zeitplandienst zum Aufrufen des Auftrags verwendet.

Beispiel: "defrag /q /f".

StartTime [ In]

koordinierte Weltzeit (UTC) zum Ausführen eines Auftrags. Das Formular muss sein: "YYYYMMDDHHMMSS. MMMMMM(+-)OOO", wobei "YYYYMMDD" durch " " ersetzt werden * * * * * * * * muss. Beispiel: * * * * * * * * "143000.000000-420" gibt 14,30 (14:30 Uhr) an. PST mit tatsächlicher Sommerzeit.

Der Abschnitt "(+-)OOO" des StartTime-Eigenschaftswerts ist die aktuelle Abweichung für die Lokale Zeitübersetzung. Die Abweichung ist der Unterschied zwischen der UTC-Zeit und der Ortszeit. Multiplizieren Sie zum Berechnen der Abweichung für Ihre Zeitzone die Anzahl der Stunden, die Ihre Zeitzone voraus oder hinter Greenwich Mean Time (GMT) liegt, mit 60 (verwenden Sie eine positive Zahl für die Anzahl der Stunden, wenn Ihre Zeitzone vor GMT liegt, und eine negative Zahl, wenn sich Ihre Zeitzone hinter GMT befindet). Fügen Sie ihrer Berechnung weitere 60 hinzu, wenn in Ihrer Zeitzone die Sommerzeit verwendet wird. Die Pacific Standard Time Zone liegt beispielsweise acht Stunden hinter GMT, daher entspricht die Abweichung -420 (-8 60 + 60), wenn Sommerzeit verwendet wird, und * -480 (-8 60), wenn die Sommerzeit nicht * verwendet wird. Sie können den Wert der Verzerrung auch ermitteln, indem Sie die Bias-Eigenschaft der Win32 _ TimeZone-Klasse abfragen.

RunRepeatedly [ in, optional]

True gibt an, dass ein geplanter Auftrag wiederholt an bestimmten Tagen ausgeführt wird. Der Standardwert ist False.

DaysOfWeek [ in, optional]

Wochentage, an denen die Ausführung eines Auftrags geplant ist; wird nur verwendet, wenn der RunRepeatedly-Parameter true ist. Um einen Auftrag für mehr als einen Tag der Woche zu planen, verbinden Sie die entsprechenden Werte in einem logischen OR. Um beispielsweise einen Auftrag für Dienstag und Freitag zu planen, ist 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, an denen die Ausführung eines Auftrags geplant ist; 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]

True gibt an, dass der angegebene Auftrag interaktiv sein sollte, was 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 einen Wert von 0 (null) und eine andere Zahl zurück, um einen Fehler anzugeben. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstistenzen 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 Dienstdatei wurde nicht gefunden.

Ungültiger Parameter

21

Ungültige Parameter wurden an den Dienst übergeben.

Der Dienst wurde 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

Hinweise

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 in der Task-Manager auch wenn er nicht auf dem Bildschirm angezeigt wird.

Anforderungen

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

Siehe auch

Betriebssystemklassen

Win32 _ ScheduledJob