Win32_ScheduledJob-Klasse

  • Artikel

Die Win32_ScheduledJobWMI-Klasse stellt einen Auftrag dar, der mit dem AT-Befehl erstellt wurde.

Hinweis

Die Win32_ScheduledJob-Klasse stellt keinen Auftrag dar, der mit dem Assistenten für geplante Aufgaben aus dem Systemsteuerung erstellt wurde. Sie können eine von WMI erstellte Aufgabe nicht auf der Benutzeroberfläche für geplante Aufgaben ändern. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

 

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften und Methoden sind in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge angeordnet.

Syntax

[Dynamic, Provider("CIMWin32"), UUID("{8502C4E0-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("Delete"), AMENDMENT]
class Win32_ScheduledJob : CIM_Job
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime ElapsedTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  datetime TimeSubmitted;
  datetime UntilTime;
  string   Command;
  uint32   DaysOfMonth;
  uint32   DaysOfWeek;
  boolean  InteractWithDesktop;
  uint32   JobId;
  string   JobStatus;
  boolean  RunRepeatedly;
  datetime StartTime;
};

Member

Die Win32_ScheduledJob-Klasse verfügt über folgende Membertypen:

Methoden

Die Win32_ScheduledJob-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
Erstellen Klassenmethode, die einen Auftrag an das Betriebssystem zur Ausführung zu einem bestimmten späteren Zeitpunkt und Datum übermittelt.
Löschen Klassenmethode, die einen geplanten Auftrag löscht.

 

Eigenschaften

Die Win32_ScheduledJob-Klasse verfügt über diese Eigenschaften.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Befehl

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | AT_INFO Befehl")

Name des Befehls, des Batchprogramms oder der Binärdatei (und der Befehlszeilenargumente), die der Zeitplandienst zum Aufrufen des Auftrags verwendet.

Beispiel: "defrag/q/f"

DaysOfMonth

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | AT_INFO DaysOfMonth")

Tage des Monats, an denen die Ausführung des Auftrags geplant ist. Wenn die Ausführung eines Auftrags an mehreren Tagen des Monats geplant ist, können diese Werte in einem logischen OR verknüpft werden. Wenn ein Auftrag beispielsweise am 1. und 16. jedes Monats ausgeführt werden soll, wäre der Wert der DaysOfMonth-Eigenschaft 1 ODER 32768.

1 (1)

1st

2 (2)

2. Platz

3 (4)

dritte

4 (8)

4.

5 (16)

5. Platz

6 (32)

6.

7 (64)

7. Platz

8 (128)

8.

9 (256)

9. Platz

10 (512)

10.

11 (1024)

11th

12 (2048)

12th

13 (4096)

13th

14 (8192)

14.

15 (16384)

15. Platz

16 (32768)

16. Platz

17 (65536)

17. Platz

18 (131072)

18. Platz

19 (262144)

19. Platz

20 (524288)

20.

21 (1048576)

21st

22 (2097152)

22nd

23 (4194304)

23rd

24 (8388608)

24. Platz

25 (16777216)

25.

26 (33554432)

26. Platz

27 (67108864)

27.

28 (134217728)

28. Platz

29 (268435456)

29.

30 (536870912)

30.

31 (1073741824)

31.

DaysOfWeek

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | AT_INFO DaysOfWeek")

Wochentage, an denen die Ausführung eines Auftrags geplant ist. Wenn ein Auftrag für die Ausführung an mehreren Wochentagen geplant ist, können die Werte in ein logisches OR eingebunden werden. Wenn ein Auftrag beispielsweise montags, mittwochs und freitags ausgeführt werden soll, ist der Wert der DaysOfWeek-Eigenschaft 1 ODER 4 ODER 16.

Montag (1)

Dienstag (2)

Mittwoch (4)

Donnerstag (8)

Freitag (16)

Samstag (32)

Sonntag (64)

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Textbeschreibung des -Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ElapsedTime

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Dauer der Ausführungszeit des Auftrags.

Diese Eigenschaft wird von CIM_Job geerbt.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts bedeutet nicht, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InteractWithDesktop

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | AT_INFO Flaggen|JOB_NONINTERACTIVE")

Der angegebene Auftrag ist interaktiv, was bedeutet, dass ein Benutzer während der Ausführung Eingaben für einen geplanten Auftrag erteilen kann.

Jobid

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Key, MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | AT_ENUM JobId")

Identifizierende Nummer des Auftrags. Es wird von Methoden als Handle für einen Auftrag verwendet, der auf diesem Computer geplant wird.

Auftragsstatus

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Überschreiben ("JobStatus"), MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | AT_ENUM Flaggen|JOB_EXEC_ERROR")

Ausführungsstatus der letzten Geplanten Ausführung dieses Auftrags.

Erfolg ("Erfolg")

Fehler ("Fehler")

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Name")

Bezeichnung, unter der das Objekt bekannt ist. Wenn sie unterklassiert wird, kann diese Eigenschaft als Schlüsseleigenschaft überschrieben werden.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Benachrichtigen

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Benutzer wird bei Abschluss oder Fehler des Auftrags benachrichtigt.

Diese Eigenschaft wird von CIM_Job geerbt.

Besitzer

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Benutzer, der den Auftrag übermittelt hat.

Diese Eigenschaft wird von CIM_Job geerbt.

Priority

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Bedeutung der Ausführung eines Auftrags.

Diese Eigenschaft wird von CIM_Job geerbt.

RunRepeatedly

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | AT_INFO Flaggen|JOB_RUN_PERIODICALLY")

Geplanter Auftrag wird wiederholt an den Tagen ausgeführt, an denen der Auftrag geplant ist. Bei False wird der Auftrag einmal ausgeführt.

StartTime

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: Überschreiben ("StartTime"), MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| | AT_ENUM JobTime")

UTC-Zeit zum Ausführen des Auftrags in Form von "JJJJMMDDHMMSS. MMMMMM(+-)OOO", wobei "JJJJMMD" durch "********" ersetzt werden muss. Der Austausch ist erforderlich, da der Terminplanungsdienst nur die Konfiguration von Aufträgen für die einmalige Ausführung oder die Ausführung an einem Tag des Monats oder der Woche zulässt. Ein Auftrag kann nicht an einem bestimmten Datum ausgeführt werden.

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.

Beispiel: "****123000.0000000-420" gibt 14.30 (14:30 Uhr) an. PST mit Sommerzeit in Kraft.

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10), DisplayName ("Status")

Zeichenfolge, die den aktuellen status des Objekts angibt. Es können operative und nicht operative status definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. ein SMART-fähiges Festplattenlaufwerk).

Nicht betriebsbereite status können "Error", "Starting", "Stop" und "Service" enthalten. "Dienst" kann beim Spiegel des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

TimeSubmitted

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Zeitpunkt, zu dem der Auftrag übermittelt wurde.

Diese Eigenschaft wird von CIM_Job geerbt.

UntilTime

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Zeitpunkt, zu dem der Auftrag ungültig ist oder beendet werden soll.

Diese Eigenschaft wird von CIM_Job geerbt.

Bemerkungen

Jeder für den Zeitplandienst geplante Auftrag wird dauerhaft gespeichert (der Planer kann einen Auftrag nach einem Neustart starten) und wird zur angegebenen Uhrzeit und zum angegebenen Tag der Woche oder des Monats ausgeführt. Wenn der Computer nicht aktiv ist oder der geplante Dienst nicht zur angegebenen Auftragszeit ausgeführt wird, führt der Zeitplandienst den angegebenen Auftrag am nächsten Tag zur angegebenen Zeit aus.

Aufträge werden gemäß koordinierter Weltzeit (UTC) mit Verzerrungsoffset von Greenwich Mean Time (GMT) geplant, was bedeutet, dass ein Auftrag mit einer beliebigen Zeitzone angegeben werden kann. Die Win32_ScheduledJob-Klasse gibt beim Aufzählen eines Objekts die Ortszeit mit UTC-Offset zurück und konvertiert beim Erstellen neuer Aufträge in die Ortszeit. Beispielsweise wird ein Auftrag, der für die Ausführung auf einem Computer in Boston am Montag um 22:30 Uhr PST-Zeit angegeben ist, für die lokale Ausführung um 1:30 Uhr am Dienstag EST geplant.

Hinweis

Ein Client muss berücksichtigen, ob die Sommerzeit auf dem lokalen Computer in Betrieb ist oder nicht, und wenn dies der Grund ist, subtrahieren Sie eine Verzerrung von 60 Minuten vom UTC-Offset.

 

Die Win32_ScheduledJob-Klasse wird von CIM_Job abgeleitet. Sie müssen Mitglied der Administratorgruppe sein, um einen geplanten Auftrag mit dieser Klasse zu erstellen.

Die Win32_ScheduledJob-Klasse verwendet intern das AT-Protokoll, das ab Windows 8 und Windows Server 2012 an die Veraltetkeit gebunden ist. Im ersten Schritt ist das AT-Protokoll standardmäßig deaktiviert. Wenn das Protokoll deaktiviert ist, schlägt beispielsweise beim Aufrufen der Create-Methode für ein Win32_ScheduledJob-Objekt ein Fehler 0x8 fehl. Sie können das AT-Protokoll wieder aktivieren, indem Sie den folgenden Registrierungseintrag hinzufügen:

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Schedule\Configuration 
Name: EnableAt 
Type: REG_DWORD
Value: 1

Möglicherweise müssen Sie den Computer neu starten, um die Einstellung wirksam zu machen.

Da Win32_ScheduledJob auf der NetScheduleJobGetInfo Win32-API basiert, können Sie diese Klasse nicht in Verbindung mit dem Aufgabenplaner verwenden. Wenn Sie den Taskplaner verwenden möchten, verwenden Sie die Aufgabenplaner-API. Weitere Informationen finden Sie in der Referenz zum Aufgabenplaner.

Beispiele

Das folgende VBScript-Codebeispiel plant, Notepad.exe jeden Mittwoch interaktiv um 1:25 Uhr bis zur lokalen Computerzeit ausgeführt werden soll.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set objNewJob = objWMIService.Get("Win32_ScheduledJob")
errJobCreated = objNewJob.Create("Notepad.exe", "********012500.000000-420", True , 4, , True, JobId) 
If errJobCreated <> 0 Then
Wscript.Echo "Error on task creation"
Else
Wscript.Echo "Task created"
End If

Anforderungen

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

Siehe auch

CIM_Job

Betriebssystemklassen

WMI-Aufgaben: Geplante Aufgaben