MSFT_StorageJob-Klasse
Stellt einen Speicherauftrag dar.
Die folgende Syntax wird vom MOF-Code (Managed Object Format) vereinfacht.
Speicheraufträge stellen zeitintensive Vorgänge in einem Speichersubsystem dar. Diese Vorgänge können auf eine der folgenden Arten initiiert werden:
- Von Benutzern, über die verschiedenen Verwaltungsschnittstellen, die von diesem MOF definiert werden.
- Automatisch durch intelligente Speichersubsysteme.
Syntax
class MSFT_StorageJob : MSFT_StorageObject
{
String Name;
String Description;
Datetime ElapsedTime;
UInt16 ErrorCode;
String ErrorDescription;
UInt16 JobState;
String JobStatus;
UInt16 LocalOrUtcTime;
UInt16 OperationalStatus[];
String StatusDescriptions[];
UInt16 PercentComplete;
Datetime StartTime;
Datetime TimeBeforeRemoval;
Datetime TimeOfLastStateChange;
Datetime TimeSubmitted;
Boolean DeleteOnCompletion;
Boolean IsBackgroundTask;
UInt16 RecoveryAction;
String OtherRecoveryAction;
};
Member
Die MSFT_StorageJob-Klasse verfügt über folgende Membertypen:
Methoden
Die MSFT_StorageJob-Klasse verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| GetExtendedStatus | Ruft erweiterte status Informationen für einen nicht erfolgreichen Speicherauftrag ab. |
| RequestStateChange | Fordert an, dass der Status des Auftrags in den im RequestedState-Parameter angegebenen Wert geändert wird. |
Eigenschaften
Die MSFT_StorageJob-Klasse verfügt über diese Eigenschaften.
DeleteOnCompletion
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Bei TRUE wird der Speicherauftrag nach einem kurzen Zeitintervall automatisch gelöscht.
Beschreibung
Datentyp: String
Zugriffstyp: Schreibgeschützt
Eine Textbeschreibung des Vorgangs, den der Speicherauftrag nachverfolgt.
ElapsedTime
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Wenn der Auftrag noch ausgeführt wird, gibt diese Eigenschaft an, wie lange er ausgeführt wurde. Wenn der Auftrag abgeschlossen ist, ist dies die Gesamtausführungszeit.
ErrorCode
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Wenn der Vorgang, den dieser Speicherauftrag nachverfolgt hat, fehlgeschlagen ist, legt der Anbieter diese Eigenschaft auf einen Fehlercode fest, der von der Methode definiert wird, die den Vorgang aufgerufen hat. Wenn dieser Speicherauftrag eine Hintergrundaufgabe nachverfolgt hat, kann der Fehlercode auf einen beliebigen gültigen Fehlercode für die Speicherverwaltung festgelegt werden, wie in der folgenden Wertezuordnung definiert. Wenn kein Fehler aufgetreten ist, muss diese Eigenschaft auf Success festgelegt werden. Diese Eigenschaft sollte NULL sein, bis der Vorgang abgeschlossen ist.
ErrorDescription
Datentyp: String
Zugriffstyp: Schreibgeschützt
Eine Freiformzeichenfolge, die die Fehlerbeschreibung des Anbieters enthält.
IsBackgroundTask
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: Erforderlich
Wenn TRUE, stellt dieser Speicherauftrag eine automatisierte Hintergrundaufgabe dar, die vom Speichersubsystem initiiert wird. Für alle vom Benutzer oder von der Verwaltung initiierten Vorgänge sollte dieser Wert auf FALSE festgelegt werden.
JobState
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Qualifizierer: Erforderlich
Der Status des Auftrags.
Neu (2)
Ab (3)
Wird ausgeführt (4)
Angehalten (5)
Herunterfahren (6)
Abgeschlossen (7)
Beendet (8)
Getötet (9)
Ausnahme (10)
Dienst (11)
Abfrage ausstehend (12)
Microsoft Reserviert (13..32767)
Anbieter reserviert (32768..65535)
JobStatus
Datentyp: String
Zugriffstyp: Schreibgeschützt
Eine Freiformzeichenfolge, die die status des Auftrags darstellt. Die primäre status wird in der OperationalStatus-Eigenschaft angezeigt. JobStatus bietet zusätzliche implementierungsspezifische Details.
LocalOrUtcTime
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Qualifizierer: Werte ( "Local Time", "UTC Time" ), ValueMap ("1", "2")
Gibt an, ob die Zeitwerte in den Eigenschaften RunStartInterval und UntilTime die Ortszeit oder UTC-Zeit darstellen. Zeitwerte werden weltweit synchronisiert, indem diese Eigenschaft auf UTC-Zeit festgelegt wird.
Name
Datentyp: String
Zugriffstyp: Schreibgeschützt
Qualifizierer: Erforderlich
Ein systemdefinierter Name für den Speicherauftrag.
OperationalStatus
Datentyp: UInt16-Array
Zugriffstyp: Schreibgeschützt
Qualifizierer: Erforderlich
Gibt die aktuelle status jedes Speichersubsystems an, das am Speicherauftrag teilnimmt.
| Wert | Bedeutung |
|---|---|
| Unbekannt 0 | Die operative status ist unbekannt. |
| Sonstige 1 | Ein anbieterspezifischer OperationalStatus wird in der OtherOperationalStatusDescription-Eigenschaft angegeben. |
| OK 2 | Das Speichersubsystem reagiert auf Befehle und befindet sich in einem normalen Betriebszustand. |
| Beeinträchtigt 3 | Das Speichersubsystem reagiert auf Befehle, wird aber nicht in einem optimalen Betriebszustand ausgeführt. |
| Gestresst 4 | Das Speichersubsystem funktioniert, benötigt jedoch Aufmerksamkeit. Beispielsweise kann es überlastet oder überhitzt sein. |
| Vorhersagefehler 5 | Das Speichersubsystem funktioniert, wird aber wahrscheinlich in naher Zukunft fehlschlagen. |
| Fehler 6 | Es ist ein Fehler aufgetreten. |
| Nicht wiederherstellbarer Fehler 7 | Ein nicht wiederherstellbarer Fehler ist aufgetreten. |
| Ab 8 | Das Speichersubsystem wird gerade gestartet. |
| Beenden von 9 | Das Speichersubsystem wird gerade beendet. |
| Beendet 10 | Das Speichersubsystem wurde sauber und ordnungsgemäß beendet oder heruntergefahren. |
| In Dienst 11 | Das Speichersubsystem wird konfiguriert, verwaltet, bereinigt oder anderweitig verwaltet. |
| Kein Kontakt 12 | Der Speicheranbieter kennt das Speichersubsystem, konnte aber noch nie mit diesem kommunizieren. |
| Kommunikation verloren 13 | Der Speicheranbieter kennt das Speichersubsystem und hat in der Vergangenheit mit dem Speichersubsystem kommuniziert, kann aber derzeit nicht mit diesem kommunizieren. |
| Abgebrochen 14 | Das Speichersubsystem wurde abrupt beendet und erfordert möglicherweise Konfiguration oder Wartung. |
| Ruhende 15 | Der Speicheranbieter kann sich mit dem Speichersubsystem in Verbindung setzen, aber das Speichersubsystem ist derzeit nicht aktiv. |
| Unterstützende Entität in Fehler 16 | Dieser Wert gibt an, dass ein anderes Gerät oder eine andere Verbindung, von der das Speichersubsystem abhängt, möglicherweise Aufmerksamkeit benötigen. Dies weist nicht unbedingt auf Probleme mit dem Speichersubsystem selbst hin. |
| Abgeschlossen 17 | Das Speichersubsystem hat einen Vorgang abgeschlossen. Dieser Wert sollte je nach Ergebnis des Vorgangs mit "OK", "Error" oder "Degraded" kombiniert werden. |
| Energiemodus 18 | Dieser Wert ist für die Verwendung durch das System reserviert. |
| DMTF Reserviert . | Werte zwischen 18 und 0x8000 (exklusiv) sind für DMTF reserviert. |
| Anbieter reserviert 0x8000.. | Werte, die größer als oder gleich 0x8000 sind für Anbieter reserviert. |
OtherRecoveryAction
Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Eine anbieterspezifische Wiederherstellungsaktion, die für einen nicht erfolgreich ausgeführten Auftrag ausgeführt werden soll. Diese Eigenschaft sollte nur festgelegt werden, wenn RecoveryAction auf Andere festgelegt ist.
PercentComplete
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Qualifizierer: Erforderlich, Einheiten (Prozentsatz)
Der Prozentsatz des Auftrags, der zum Zeitpunkt der Anforderung dieses Werts abgeschlossen wurde.
RecoveryAction
Datentyp: UInt16
Zugriffstyp: Schreibgeschützt
Beschreibt die Wiederherstellungsaktion, die für einen nicht erfolgreich ausgeführten Auftrag ausgeführt werden soll. Einer der folgenden Werte.
| Wert | Bedeutung |
|---|---|
| Unbekannt 0 | Die gewünschte Wiederherstellungsaktion ist unbekannt. |
| Sonstige 1 | Die Wiederherstellungsaktion wird in der OtherRecoveryAction-Eigenschaft angegeben. |
| Nicht fortfahren 2 | Beenden Sie die Ausführung des Speicherauftrags, und aktualisieren Sie den status entsprechend. |
| Fahren Sie mit dem nächsten Auftrag 3 fort. | Fahren Sie mit dem nächsten Auftrag in der Warteschlange fort. |
| Erneutes Ausführen von Auftrag 4 | Führen Sie den Auftrag erneut aus. |
StartTime
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Der Zeitpunkt, zu dem der Auftrag gestartet wurde.
StatusBeschreibungen
Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt
Beschreibungen der OperationalStatus-Werte . Wenn Stop beispielsweise ein Wert in OperationalStatus ist, kann das entsprechende Arrayelement von StatusDescriptions erklären, warum ein Objekt beendet wird.
TimeBeforeRemoval
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Die Zeitspanne in Sekunden, die der Auftrag beibehalten wird, nachdem er die Ausführung abgeschlossen hat, entweder erfolgreich oder fehlgeschlagen in dieser Ausführung. Der Auftrag muss unabhängig vom Wert der DeleteOnCompletion-Eigenschaft für einen bestimmten Zeitraum bestehen bleiben.
TimeOfLastStateChange
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Der Zeitpunkt, zu dem sich der Status des Auftrags zuletzt geändert hat. Wenn sich der Zustand des Auftrags nicht geändert hat und diese Eigenschaft keinen Wert aufweist, muss er auf 0 festgelegt werden. Wenn eine Zustandsänderung angefordert, aber abgelehnt wurde oder noch nicht verarbeitet wurde, darf der Wert dieser Eigenschaft nicht aktualisiert werden.
TimeSubmitted
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Der Zeitpunkt, zu dem der Auftrag zur Ausführung übermittelt wurde. Ein Wert mit allen Nullen gibt an, dass das besitzende Element kein Datum und eine Uhrzeit melden kann. Daher werden scheduledStartTime und StartTime als Intervalle relativ zum Zeitpunkt der Anforderung ihrer Werte gemeldet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Stamm\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |