Win32 _ ScheduledJob-Klasse

Die WMI-Klasse _ Win32 ScheduledJob   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. Sie können einen von WMI erstellten Task nicht auf der Benutzeroberfläche für geplante Aufgaben ändern. Weitere Informationen finden Sie im Abschnitt "Hinweise".

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.

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;
};

Members

Die Win32 _ ScheduledJob-Klasse verfügt über die folgenden 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 einer bestimmten zukünftigen Zeit und einem bestimmten Datum übermittelt.
Löschen Klassenmethode, die einen geplanten Auftrag löscht.

Eigenschaften

Die Win32 _ ScheduledJob-Klasse verfügt über diese Eigenschaften.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

Befehl

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API-Netzwerkverwaltungsstrukturen | | AT _ INFO-Befehl | ")

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

Beispiel: "defrag /q/f"

DaysOfMonth

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API | Network Management Structures 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-Operator verbunden 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)

2 (2)

3 (4)

dritte

4 (8)

5 (16)

6 (32)

7 (64)

8 (128)

9 (256)

10 (512)

11 (1024)

11th

12 (2048)

12th

13 (4096)

13th

14 (8192)

15 (16384)

16 (32768)

17 (65536)

18 (131072)

19 (262144)

20 (524288)

21 (1048576)

21st

22 (2097152)

22nd

23 (4194304)

23rd

24 (8388608)

25 (16777216)

26 (33554432)

27 (67108864)

28 (134217728)

29 (268435456)

30 (536870912)

31 (1073741824)

DaysOfWeek

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API-Netzwerkverwaltungsstrukturen | | AT _ INFO | DaysOfWeek")

Wochentage, an denen die Ausführung eines Auftrags geplant ist. Wenn die Ausführung eines Auftrags an mehreren Tagen der Woche geplant ist, können die Werte in einem logischen OR-Operator verbunden werden. Wenn ein Auftrag beispielsweise für montags, mittwochs und freitags geplant ist, wäre 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

Die Zeitdauer, die der Auftrag ausgeführt wurde.

Diese Eigenschaft wird vom _ CIM-Auftrag geerbt.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

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

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

Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

InteractWithDesktop

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API | Network Management Structures AT | _ INFO | Flags | JOB _ NONINTERACTIVE")

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

Jobid

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel, MappingStrings ("Win32API-Netzwerkverwaltungsstrukturen | AT | _ ENUM | JobId")

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

Auftragsstatus

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Override ("JobStatus"), MappingStrings ("Win32API | Network Management Structures AT | _ ENUM | Flags | JOB _ EXEC _ ERROR")

Ausführungsstatus bei 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. Bei Unterklassen kann diese Eigenschaft überschrieben werden, um eine Schlüsseleigenschaft zu sein.

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 vom _ CIM-Auftrag geerbt.

Besitzer

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Benutzer, der den Auftrag übermittelt hat.

Diese Eigenschaft wird vom _ CIM-Auftrag geerbt.

Priority

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Wichtigkeit der Ausführung eines Auftrags.

Diese Eigenschaft wird vom _ CIM-Auftrag geerbt.

RunRepeatedly

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API | Network Management Structures AT | _ INFO | Flags | JOB RUN _ _ PERIODICALLY")

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

StartTime

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: Override ("StartTime"), MappingStrings ("Win32API | Network Management Structures AT | _ ENUM | JobTime")

UTC-Zeit zum Ausführen des Auftrags in Form von "YYYYMMDDHHMMSS. MMMMMM(+-)OOO", wobei "YYYYMMDD" durch " " ersetzt werden * * * * * * * * muss. Die Ersetzung ist erforderlich, da der Planungsdienst nur die einmalige Ausführung von Aufträgen 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 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.

Beispiel: * * * * * * * * "123000.000000-420" gibt 14,30 (14:30 Uhr) an. PST mit tatsächlicher Sommerzeit.

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

Zeichenfolge, die den aktuellen Status des Objekts angibt. Der Betriebsstatus und der nicht betriebsbereite Status können definiert werden. Der Betriebsstatus kann "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" 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", "Stopping" und "Service" sein. "Dienst" kann während der Datenträgerspiegelung, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle dieser Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Heruntergestuft ("Heruntergestuft")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Beenden ("Wird beendet")

Dienst ("Dienst")

1600000000000

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Verlorenes Komma ("Verlorenes Komma")

TimeSubmitted

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Der Zeitpunkt, zu dem der Auftrag übermittelt wurde.

Diese Eigenschaft wird vom _ CIM-Auftraggeerbt.

UntilTime

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

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

Diese Eigenschaft wird vom _ CIM-Auftraggeerbt.

Bemerkungen

Jeder für den Zeitplandienst geplante Auftrag wird dauerhaft gespeichert (der Planer kann einen Auftrag nach einem Neustart starten) und wird zum angegebenen Zeitpunkt und 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 zum angegebenen Zeitpunkt aus.

Aufträge werden gemäß koordinierte Weltzeit (UTC) mit Einem Voreingenommensoffset von Greenwich Mean Time (GMT) geplant. Dies bedeutet, dass ein Auftrag mit einer beliebigen Zeitzone angegeben werden kann. Die Win32 _ ScheduledJob-Klasse gibt die lokale Zeit mit UTC-Offset zurück, wenn ein Objekt aufzählt, und konvertiert beim Erstellen neuer Aufträge in die lokale Zeit. Beispiel: Ein Auftrag, der für die Ausführung auf einem Computer in Boston um 22:30 Uhr angegeben ist. Die Pst-Zeit für Montag ist für die lokale Ausführung um 1:30 Uhr geplant. Dienstag EST.

Hinweis

Ein Client muss berücksichtigen, ob die Sommerzeit auf dem lokalen Computer in Betrieb ist, und bei Bedarf eine Verschiebung von 60 Minuten vom UTC-Offset subtrahieren.

Die Win32 _ ScheduledJob-Klasse wird von _ CIM-Auftragabgeleitet. Sie müssen Mitglied der Administratorengruppe 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 veraltet ist. Im ersten Schritt ist das AT-Protokoll standardmäßig deaktiviert. Wenn das Protokoll deaktiviert ist, tritt beispielsweise beim Aufrufen der Create-Methode für ein Win32 _ ScheduledJob-Objekt ein Fehler 0x8 auf. 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, damit die Einstellung wirksam wird.

Da Win32 _ ScheduledJob auf der NetScheduleJobGetInfo Win32-API basiert, können Sie diese Klasse nicht in Verbindung mit dem Taskplaner verwenden. Wenn Sie Taskplaner verwenden möchten, verwenden Sie die Taskplaner-API. Weitere Informationen finden Sie in der Taskplaner Reference.

Beispiele

Im folgenden VBScript-Codebeispiel wird geplant, dass Notepad.exe jeden Mittwoch um 1:25 Uhr vom lokalen Computer interaktiv ausgeführt wird.

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

Requirements (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

Weitere Informationen

_CIM-Auftrag

Betriebssystemklassen

WMI-Aufgaben: Geplante Aufgaben