classe MSFT_StorageJob
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 |