classe MSFT_StorageJob

  • Article

Représente un travail de stockage.

La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format).

Les travaux de stockage représentent des opérations de longue durée sur un sous-système de stockage. Ces opérations peuvent être lancées de l’une des manières suivantes :

  • Par les utilisateurs, via les différentes interfaces de gestion définies par ce MOF.
  • Automatiquement, par sous-systèmes de stockage intelligent.

Syntaxe

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

Membres

La classe MSFT_StorageJob a les types de membres suivants :

Méthodes

La classe MSFT_StorageJob a ces méthodes.

Méthode Description
GetExtendedStatus Récupère les informations status étendues pour un travail de stockage ayant échoué.
RequestStateChange Demande que l’état du travail soit remplacé par la valeur spécifiée dans le paramètre RequestedState .

Propriétés

La classe MSFT_StorageJob possède ces propriétés.

DeleteOnCompletion

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est TRUE, la tâche de stockage est automatiquement supprimée après un court intervalle de temps.

Description

Type de données : Chaîne

Type d'accès : Lecture seule

Description textuelle de l’opération que le travail de stockage suit.

Heure écoulée

Type de données : Datetime

Type d'accès : Lecture seule

Si le travail est toujours en cours d’exécution, cette propriété indique la durée de son exécution. Si le travail est terminé, il s’agit du temps d’exécution total.

ErrorCode

Type de données : UInt16

Type d'accès : Lecture seule

Si l’opération suivie par ce travail de stockage a échoué, le fournisseur définit cette propriété sur un code d’erreur défini par la méthode qui a appelé l’opération. Si ce travail de stockage faisait le suivi d’une tâche en arrière-plan, le code d’erreur peut être défini sur n’importe quel code d’erreur de gestion du stockage valide, comme défini dans le mappage de valeurs ci-dessous. En l’absence d’erreur, cette propriété doit être définie sur Success. Cette propriété doit avoir la valeur NULL jusqu’à ce que l’opération soit terminée.

ErrorDescription

Type de données : Chaîne

Type d'accès : Lecture seule

Chaîne de forme libre qui contient la description de l’erreur du fournisseur.

IsBackgroundTask

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : obligatoire

Si la valeur est TRUE, cette tâche de stockage représente une tâche en arrière-plan automatisée lancée par le sous-système de stockage. Pour toutes les opérations initiées par l’utilisateur ou la gestion, cette valeur doit être définie sur FALSE.

JobState

Type de données : UInt16

Type d'accès : Lecture seule

Qualificateurs : obligatoire

État du travail.

Nouveau (2)

Début (3)

En cours d’exécution (4)

Suspendu (5)

Arrêt ( 6)

Terminé (7)

Terminé (8)

Tué (9)

Exception (10)

Service (11)

Requête en attente (12)

Microsoft Réservé (13..32767)

Fournisseur réservé (32768..65535)

JobStatus

Type de données : Chaîne

Type d'accès : Lecture seule

Chaîne de forme libre qui représente le status du travail. La status principale est reflétée dans la propriété OperationalStatus. JobStatus fournit des détails supplémentaires spécifiques à l’implémentation.

LocalOrUtcTime

Type de données : UInt16

Type d'accès : Lecture seule

Qualificateurs : Valeurs ( « Heure locale », « Heure UTC »), ValueMap (« 1 », « 2 »)

Indique si les valeurs d’heure des propriétés RunStartInterval et UntilTime représentent l’heure locale ou l’heure UTC. Les valeurs d’heure sont synchronisées dans le monde entier en définissant cette propriété sur Heure UTC.

Nom

Type de données : Chaîne

Type d'accès : Lecture seule

Qualificateurs : obligatoire

Nom défini par le système pour le travail de stockage.

OperationalStatus

Type de données : tableau UInt16

Type d'accès : Lecture seule

Qualificateurs : obligatoire

Indique le status actuel de chaque sous-système de stockage participant au travail de stockage.

Valeur Signification
Inconnu 0 Le status opérationnel est inconnu.
Autre 1 Un OperationalStatus propre au fournisseur est spécifié dans la propriété OtherOperationalStatusDescription .
OK 2 Le sous-système de stockage répond aux commandes et est dans un état de fonctionnement normal.
Détérioré 3 Le sous-système de stockage répond aux commandes, mais ne s’exécute pas dans un état de fonctionnement optimal.
Stressé 4 Le sous-système de stockage fonctionne, mais nécessite une attention particulière. Par exemple, il peut être surchargé ou surchauffé.
Échec prédictif 5 Le sous-système de stockage fonctionne, mais il risque d’échouer dans un avenir proche.
Erreur 6 Une erreur s’est produite.
Erreur non récupérable 7 Une erreur non récupérable s’est produite.
Début 8 Le sous-système de stockage est en cours de démarrage.
Arrêt 9 Le sous-système de stockage est en cours d’arrêt.
Arrêté 10 Le sous-système de stockage a été arrêté ou arrêté de manière propre et ordonnée.
Dans le service 11 Le sous-système de stockage est en cours de configuration, de maintenance, de nettoyage ou d’administration.
Aucun contact 12 Le fournisseur de stockage connaît le sous-système de stockage, mais n’a jamais été en mesure de communiquer avec lui.
Communication perdue 13 Le fournisseur de stockage connaît le sous-système de stockage et a déjà communiqué avec lui, mais il ne peut pas communiquer avec lui.
Abandonné 14 Le sous-système de stockage a été arrêté brusquement et peut nécessiter une configuration ou une maintenance.
Dormant 15 Le fournisseur de stockage peut contacter le sous-système de stockage, mais le sous-système de stockage n’est pas actif.
Entité de prise en charge dans l’erreur 16 Cette valeur indique qu’un autre appareil ou connexion dont dépend le sous-système de stockage peut nécessiter une attention particulière. Cela n’indique pas nécessairement des problèmes avec le sous-système de stockage lui-même.
Terminé 17 Le sous-système de stockage a terminé une opération. Cette valeur doit être combinée avec « OK », « Erreur » ou « Détérioré », selon le résultat de l’opération.
Mode Alimentation 18 L’utilisation de cette valeur est réservée au système.
DMTF Reserved .. Les valeurs comprises entre 18 et 0x8000 (exclusif) sont réservées à DMTF.
Fournisseur réservé 0x8000.. Les valeurs supérieures ou égales à 0x8000 sont réservées aux fournisseurs.

OtherRecoveryAction

Type de données : Chaîne

Type d'accès : Lecture seule

Action de récupération spécifique au fournisseur à effectuer pour un travail qui ne s’exécute pas correctement. Cette propriété ne doit être définie que si RecoveryAction a la valeur Other.

PercentComplete

Type de données : UInt16

Type d'accès : Lecture seule

Qualificateurs : Obligatoire, Unités (Pourcentage)

Pourcentage du travail qui s’est terminé au moment où cette valeur est demandée.

RecoveryAction

Type de données : UInt16

Type d'accès : Lecture seule

Décrit l’action de récupération à entreprendre pour un travail exécuté sans succès. Une des valeurs suivantes.

Valeur Signification
Inconnu 0 L’action de récupération souhaitée est inconnue.
Autre 1 L’action de récupération est spécifiée dans la propriété OtherRecoveryAction .
Ne pas continuer 2 Arrêtez l’exécution du travail de stockage et mettez à jour son status de manière appropriée.
Continuer avec le travail suivant 3 Passez au travail suivant dans la file d’attente.
Réexécuter le travail 4 Réexécutez le travail.

StartTime

Type de données : Datetime

Type d'accès : Lecture seule

Heure à laquelle le travail a été démarré.

StatusDescriptions

Type de données : Tableau de chaînes

Type d'accès : Lecture seule

Descriptions des valeurs OperationalStatus . Par exemple, si Stopping est une valeur dans OperationalStatus, l’élément de tableau correspondant de StatusDescriptions peut expliquer pourquoi un objet est arrêté.

TimeBeforeRemoval

Type de données : Datetime

Type d'accès : Lecture seule

Durée, en secondes, pendant laquelle le travail est conservé une fois l’exécution terminée, en réussissant ou en échec dans cette exécution. Le travail doit rester en existence pendant un certain temps, quelle que soit la valeur de la propriété DeleteOnCompletion .

TimeOfLastStateChange

Type de données : Datetime

Type d'accès : Lecture seule

Heure de la dernière modification de l’état du travail. Si l’état du travail n’a pas changé et que cette propriété n’a pas de valeur, elle doit être définie sur zéro. Si une modification d’état a été demandée, mais qu’elle a été rejetée ou n’a pas encore été traitée, la valeur de cette propriété ne doit pas être mise à jour.

TimeSubmitted

Type de données : Datetime

Type d'accès : Lecture seule

Heure à laquelle le travail a été soumis pour exécution. Une valeur de tous les zéros indique que l’élément propriétaire n’est pas capable de signaler une date et une heure. Par conséquent, les valeurs ScheduledStartTime et StartTime sont signalées sous forme d’intervalles par rapport à l’heure à laquelle leurs valeurs sont demandées.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Espace de noms Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

Voir aussi

MSFT_StorageObject