MSVM _ StorageJob, classe
représente un travail d’opération de stockage créé par le Service de gestion d’images Microsoft Hyper-V.
La syntaxe suivante est simplifiée format MOF (MOF) et comprend toutes les propriétés héritées.
Syntaxe
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_StorageJob : CIM_ConcreteJob
{
string InstanceID;
string Caption;
string Description;
string ElementName;
datetime InstallDate;
string Name;
uint16 OperationalStatus[];
string StatusDescriptions[];
string Status;
uint16 HealthState = 5;
uint16 CommunicationStatus;
uint16 DetailedStatus;
uint16 OperatingStatus;
uint16 PrimaryStatus;
string JobStatus;
datetime TimeSubmitted;
datetime ScheduledStartTime;
datetime StartTime;
datetime ElapsedTime;
uint32 JobRunTimes;
uint8 RunMonth;
sint8 RunDay;
sint8 RunDayOfWeek;
datetime RunStartInterval;
uint16 LocalOrUtcTime;
datetime UntilTime;
string Notify;
string Owner;
uint32 Priority;
uint16 PercentComplete;
boolean DeleteOnCompletion;
uint16 ErrorCode;
string ErrorDescription;
string ErrorSummaryDescription;
uint16 RecoveryAction;
string OtherRecoveryAction;
uint16 JobState;
datetime TimeOfLastStateChange;
datetime TimeBeforeRemoval = 00000000000500.000000:000";
boolean Cancellable;
string Child;
UINT32 JobCompletionStatusCode;
string Parent;
uint16 JobType;
};
Membres
La classe MSVM _ StorageJob possède les types de membres suivants :
Méthodes
La classe MSVM _ StorageJob possède ces méthodes.
| Méthode | Description |
|---|---|
| GetError | Récupère l’erreur qui décrit la raison de l’échec du travail. |
| GetErrorEx | Lorsque le travail est en cours d’exécution ou s’est terminé sans erreur, cette méthode ne retourne aucune instance d' _ erreur MSVM . Toutefois, si la tâche a échoué en raison d’un problème interne ou parce que la tâche a été arrêtée par un client, une ou plusieurs instances d' _ erreur MSVM sont retournées. |
| KillJob | Cette méthode n'est pas prise en charge. |
| RequestStateChange | Demande un changement d’État. |
Propriétés
La classe MSVM _ StorageJob possède les propriétés suivantes.
-
Annulable
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si le travail peut être annulé. La valeur de cette propriété ne garantit pas qu’une demande d’annulation du travail échoue.
-
-
Caption
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Brève description de l’objet. Cette propriété est héritée de la _ propriété ManagedElement CIM.
-
-
Enfant
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
En cas d’échec de l’opération asynchrone, cette propriété contient le chemin d’accès complet de l’enfant du disque dur virtuel affecté par cette opération.
-
-
CommunicationStatus
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Indique la capacité de l’instrumentation à communiquer avec l’élément managé sous-jacent. Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
DeleteOnCompletion
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Spécifie si le travail doit être automatiquement supprimé à la fin de l’opération. Cette propriété est héritée de la _ tâche CIM.
-
-
Description
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description de l'objet . Cette propriété est héritée de la _ propriété ManagedElement CIM.
-
-
DetailedStatus
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Complète la propriété PrimaryStatus avec des détails d’État supplémentaires. Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
ElapsedTime
-
-
Type de données : DateTime
-
Type d'accès : Lecture seule
La durée d’exécution du travail. Cette propriété est héritée de la _ tâche CIM.
-
-
ElementName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom complet de l’objet. Cette propriété est héritée de la _ propriété ManagedElement CIM.
-
-
ErrorCode
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Code d’erreur spécifique au fournisseur. La valeur doit être égale à zéro si le travail s’est terminé sans erreur. Cette propriété est héritée de la _ tâche CIM.
-
-
ErrorDescription
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chaîne qui contient la description de l’erreur du fournisseur. Cette propriété est héritée de la _ tâche CIM.
-
-
ErrorSummaryDescription
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : ModelCorrespondence («_ tâche CIM.ErrorCode»)
Description résumée de l’erreur, le cas échéant. Cette propriété est héritée de la _ tâche CIM.
-
-
HealthState
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Intégrité actuelle de l’élément. Cet attribut exprime l’intégrité de cet élément, mais pas nécessairement celle de ses sous-composants. Les valeurs possibles sont comprises entre 0 et 30, où 5 signifie que l’élément est entièrement sain et 30 signifie que l’élément est complètement non opérationnel. Cette propriété est héritée de CIM _ ManagedSystemElementet est toujours définie sur 5.
-
-
InstallDate
-
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Date et heure de création de la configuration de l’ordinateur virtuel. Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
InstanceID
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Identifie de façon unique une instance de cette classe. Cette propriété est héritée de la _ propriété ManagedElement CIM.
-
-
JobCompletionStatusCode
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Code HRESULT qui décrit l’état d’achèvement de l’opération asynchrone.
-
-
JobRunTimes
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Nombre de fois où la tâche doit être exécutée. La valeur 1 indique que le travail n’est pas récurrent, tandis que toute valeur différente de zéro indique une limite au nombre de fois où le travail se reproduira. La valeur zéro indique qu’il n’y a pas de limite au nombre de fois où le travail peut être traité, mais qu’il se termine une fois que le UntilTime a été atteint ou lorsque le travail est arrêté manuellement. Cette propriété est héritée de la _ tâche CIM.
-
-
JobState
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
État opérationnel d’un travail. Il peut également indiquer des transitions entre ces États, par exemple 6 (arrêt) et 3 (à partir de). Cette propriété est héritée de la _ ConcreteJob CIM.
Valeur Signification - Nouveau
- 2
Le travail n’a jamais été démarré. - À
- partir du
- 3
Le travail passe des États « nouveau », « suspendu » ou « service » à l’État « en cours d’exécution ». - En cours d’exécution
- 4
La tâche est en cours d'exécution. - Suspendu
- 5
La tâche est arrêtée, mais elle peut être redémarrée de manière transparente. - Arrêt de
- 6
Le travail passe à l’état « terminé », « terminé » ou « mort ». - Terminé le
- 7
Le travail s’est terminé normalement. - Terminé
- 8
La tâche a été arrêtée par une demande de modification d’État « Terminate ». Le travail et tous ses processus sous-jacents sont terminés et peuvent être redémarrés uniquement en tant que nouveau travail. L’exigence de redémarrage du travail uniquement en tant que nouveau travail est spécifique à un travail. - Abattu le
- 9
La tâche a été arrêtée par une demande de modification d’État « Kill ». Les processus sous-jacents peuvent toujours être en cours d’exécution et un nettoyage peut être nécessaire pour libérer des ressources. - Exception
- 10
La tâche est dans un état anormal qui peut indiquer une condition d’erreur. L’état réel du travail peut être disponible par le biais d’objets spécifiques à un travail. - Service
- 11
La tâche est dans un état spécifique au fournisseur qui prend en charge la découverte de problèmes, la résolution, ou les deux. - DMTF réservé
- 12 32767
Réservé. - Fournisseur réservé
- 32768 65535
Réservé. -
-
JobStatus
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chaîne qui représente l’état de la tâche. Cette propriété est héritée de la _ tâche CIM.
-
-
JobType
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Type d’opération asynchrone faisant l’objet d’un suivi par cette instance de MSVM _ StorageJob.
-
-
Inconnu (0)
-
Création d’un disque dur virtuel (1)
-
Création d’une image de disque dur virtuel (VHD).
-
Création de disquette (2)
-
Création d’une image de disquette virtuelle (VFD).
-
Compactage (3)
-
Compactage de la taille d’une image de disque dur virtuel.
-
Expansion (4)
-
Extension de la taille d’une image de disque dur virtuel.
-
Fusion (5)
-
Fusion de plusieurs images VHD en une seule image.
-
Conversion (6)
-
Conversion du type d’une image de disque dur virtuel.
-
Montage en boucle (7)
-
Montage du disque dur virtuel sur la partition parente
-
Récupération d’informations sur VHD (8)
-
Montage du disque dur virtuel sur le système d’exploitation de gestion.
-
Valider l’image VHD (9)
LocalOrUtcTime
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Indique si les heures représentées dans les propriétés RunStartInterval et UntilTime représentent des heures locales ou des heures UTC. Cette propriété est héritée de la _ tâche CIM.
-
Heure locale (1)
-
Heure UTC (2)
Nom
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Étiquette par laquelle l’objet est connu. Cette propriété est héritée de CIM _ ManagedSystemElement.
Notifier
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Utilisateur qui est averti en cas d’achèvement ou d’échec d’un travail. Cette propriété est héritée de la _ tâche CIM.
OperatingStatus
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Fournit des informations sur l’état actuel de la condition opérationnelle de l’élément et peut être utilisé pour fournir plus de détails concernant la valeur de la propriété EnabledState . Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.
OperationalStatus
-
Type de données : tableau UInt16
-
Type d'accès : Lecture seule
États actuels de l’objet. Cette propriété est héritée de CIM _ ManagedSystemElement.
OtherRecoveryAction
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chaîne qui décrit l’action de récupération lorsque la propriété RecoveryAction de l’instance a la valeur 1 (autre). Cette propriété est héritée de la _ tâche CIM.
Propriétaire
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Utilisateur qui a envoyé le travail. Cette propriété est héritée de la _ tâche CIM.
Parent
-
Type de données : chaîne
-
Type d'accès : Lecture seule
En cas d’échec de l’opération asynchrone, cette propriété contient le chemin d’accès du fichier au parent du disque dur virtuel affecté par cette opération.
PercentComplete
-
Type de données : UInt16
-
Type d'accès : Lecture seule
-
Qualificateurs : MinValue (0), MaxValue (100), unités (« percent »)
Pourcentage d’achèvement du travail. Cette propriété est héritée de la _ tâche CIM.
PrimaryStatus
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Fournit des informations d’état de haut niveau. Cette propriété doit être utilisée conjointement avec la propriété DetailedStatus pour fournir un état d’intégrité élevé et détaillé de l’élément et de ses sous-composants. Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.
Priorité
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Importance de l’exécution d’un travail. Cette propriété est héritée de la _ tâche CIM.
RecoveryAction
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Décrit l’action de récupération à entreprendre pour un travail qui n’a pas été exécuté avec succès. Cette propriété est héritée de la _ tâche CIM.
-
Inconnu (0)
-
Autre (1)
-
Ne pas continuer (2)
-
Continuer avec la tâche suivante (3)
-
Travail de réexécution (4)
-
Exécuter la tâche de récupération (5)
RunDay
-
Type de données : sint8
-
Type d'accès : Lecture seule
-
Qualificateurs : MinValue (-31), MaxValue (31)
Jour du mois sur lequel le travail doit être traité. Il existe différentes interprétations pour cette propriété, en fonction de la valeur de RunDayOfWeek.
Quand RunDayOfWeek a la valeur 0 et que RunDay est positif, RunDay définit le jour du mois où le travail est traité. Par exemple, si RunDayOfWeek est égal à 0 et que RunDay est égal à 12, la tâche est traitée le 12 ème jour du mois.
Quand RunDayOfWeek a la valeur 0 et que RunDay est négatif, RunDay définit le nombre de jours avant le dernier jour du mois où le travail est traité. 1 indique le dernier jour du mois, 2 indique un jour avant le dernier jour du mois, et ainsi de suite. Par exemple, si RunDayOfWeek est égal à 0 et RunDay la valeur 1, la tâche est traitée le dernier jour du mois.
Quand RunDayOfWeek n’est pas égal à 0, RunDayOfWeek est le jour de la semaine où le travail sera traité, par rapport à RunDay. Par exemple, si RunDay est 15 et RunDayOfWeek est 7 (+ samedi), le travail sera traité le premier samedi, le ou après le 15 ème jour du mois. Si RunDay est 20 et RunDayOfWeek est 7 (samedi), la tâche est traitée le premier samedi le ou avant le 20 ème jour du mois. Si RunDay est 1 et que RunDayOfWeek est 1 (dimanche), la tâche est traitée le dernier dimanche du mois.
Cette propriété est héritée de la _ tâche CIM.
RunDayOfWeek
-
Type de données : sint8
-
Type d'accès : Lecture seule
Entier positif ou négatif utilisé conjointement avec RunDay pour indiquer le jour de la semaine ou du mois où le travail est traité. Pour plus d’informations, consultez la description de la propriété RunDay . Cette propriété est héritée de la _ tâche CIM.
-
-Samedi (7)
-
-Vendredi (6)
-
-Jeudi (5)
-
-Mercredi (4)
-
-Mardi (3)
-
-Lundi (2)
-
-Dimanche (1)
-
ExactDayOfMonth (0)
-
Dimanche (1)
-
Lundi (2)
-
Mardi (3)
-
Mercredi (4)
-
Jeudi (5)
-
Vendredi (6)
-
Samedi (7)
RunMonth
-
Type de données : UInt8
-
Type d'accès : Lecture seule
Mois pendant lequel le travail doit être traité. Cette propriété est héritée de la _ tâche CIM.
-
Janvier (0)
-
Février (1)
-
Mars (2)
-
Avril (3)
-
Mai (4)
-
Juin (5)
-
Juillet (6)
-
Août (7)
-
Septembre (8)
-
Octobre (9)
-
Novembre (10)
-
Décembre (11)
RunStartInterval
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Intervalle de temps après minuit lorsque le travail doit être traité. Cette propriété est héritée de la _ tâche CIM.
ScheduledStartTime
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Cette propriété est héritée de la _ tâche CIM.
StartTime
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Heure de début de la tâche. Cette propriété est héritée de la _ tâche CIM.
État
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Cette propriété est héritée de CIM _ ManagedSystemElement, mais elle n’est pas utilisée.
StatusDescriptions
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
Chaînes qui décrivent les différentes valeurs de tableau OperationalStatus . Cette propriété est héritée de CIM _ ManagedSystemElement.
TimeBeforeRemoval
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Durée, en minutes, pendant laquelle le travail est conservé une fois qu’il a fini de s’exécuter, soit à l’issue ou à l’échec de cette exécution. Le travail doit rester en présence pendant un certain temps, quelle que soit la valeur de la propriété DeleteOnCompletion . La valeur par défaut est cinq minutes. Cette propriété est héritée de la _ ConcreteJob CIMet est toujours définie sur 00000000000500.000000:000.
TimeOfLastStateChange
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Heure de la dernière modification de l’état de la machine virtuelle. Cette propriété est héritée de la _ EnabledLogicalElement CIM.
TimeSubmitted
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Heure à laquelle le travail a été soumis. Cette propriété est héritée de la _ tâche CIM.
UntilTime
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Heure à laquelle le travail n’est pas valide ou doit être arrêté. Cette propriété est héritée de la _ tâche CIM.
Remarques
L’accès à la classe MSVM _ StorageJob peut être limité par le filtrage UAC. Pour plus d’informations, consultez contrôle de compte d’utilisateur et WMI.
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 |
\Virtualisation racine \ v2 |
| MOF |
|
| DLL |
|