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)

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

Siehe auch

Betriebssystemklassen

Win32_ScheduledJob