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 |
|
| DLL |
|