classe Msvm_StorageJob

  • Article

Représente une tâche d’opération de stockage créée par le service de gestion des images Microsoft Hyper-V.

La syntaxe suivante est le code MOF (Managed Object Format) simplifié et inclut 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 a les types de membres suivants :

Méthodes

La classe Msvm_StorageJob a 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 s’exécute ou s’est terminé sans erreur, cette méthode ne retourne aucune Msvm_Error instance. Toutefois, si le travail a échoué en raison d’un problème interne ou si le travail a été arrêté par un client, une ou plusieurs instances Msvm_Error 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 ces propriétés.

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 aboutira.

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 CIM_ManagedElement.

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é une fois terminé. Cette propriété est héritée de CIM_Job.

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 CIM_ManagedElement.

DetailedStatus

Type de données : uint16

Type d'accès : Lecture seule

Complète la propriété PrimaryStatus avec des détails status 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.

Heure écoulée

Type de données : datetime

Type d'accès : Lecture seule

Durée d’exécution du travail. Cette propriété est héritée de CIM_Job.

ElementName

Type de données : chaîne

Type d'accès : Lecture seule

Nom d’affichage de l’objet. Cette propriété est héritée de CIM_ManagedElement.

ErrorCode

Type de données : uint16

Type d'accès : Lecture seule

Code d’erreur propre au fournisseur. La valeur doit être définie sur zéro si le travail s’est terminé sans erreur. Cette propriété est héritée de CIM_Job.

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 CIM_Job.

ErrorSummaryDescription

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_Job. ErrorCode »)

Description récapitulative de l’erreur, le cas échéant. Cette propriété est héritée de CIM_Job.

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 de 0 à 30, où 5 signifie que l’élément est entièrement sain et 30 signifie que l’élément est complètement non fonctionnel. Cette propriété est héritée de CIM_ManagedSystemElement et 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 la machine virtuelle. 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 manière unique un instance de cette classe. Cette propriété est héritée de CIM_ManagedElement.

JobCompletionStatusCode

Type de données : UINT32

Type d'accès : Lecture seule

Code HRESULT qui décrit l’achèvement status pour l’opération asynchrone.

JobRunTimes

Type de données : uint32

Type d'accès : Lecture seule

Nombre de fois où le travail doit être exécuté. 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 répétitions du travail. Zéro indique qu’il n’existe aucune limite au nombre de fois où le travail peut être traité, mais qu’il sera arrêté une fois que l’heure d’attente a été atteinte ou que le travail est arrêté manuellement. Cette propriété est héritée de CIM_Job.

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 (Démarrage). Cette propriété est héritée de CIM_ConcreteJob.

Valeur Signification
Nouveau
2
 Le travail n’a jamais commencé.
Démarrage en cours
3
 Le travail passe de l’état « Nouveau », « Suspendu » ou « Service » à l’état « En cours d’exécution ».
Exécution
4
 La tâche est en cours d'exécution.
Suspendu
5
 Le travail est arrêté, mais il peut être redémarré de manière transparente.
Fermeture
6
 Le travail passe à l’état « Terminé », « Terminé » ou « Tué ».
Terminé
7
 Le travail s’est terminé normalement.
Terminé
8
 Le travail a été arrêté par une demande de changement d’état « Terminer ». 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 selon laquelle le travail doit être redémarré uniquement en tant que nouveau travail est spécifique à la tâche.
Killed
9
 Le travail a été arrêté par une demande de modification d’état « Kill ». Les processus sous-jacents peuvent toujours être en cours d’exécution et une propre peut être nécessaire pour libérer des ressources.
Exception
10
 Le travail est dans un état anormal qui peut indiquer une condition d’erreur. La status réelle du travail peut être disponible via des objets spécifiques au travail.
Service
11
 Le travail est dans un état spécifique au fournisseur qui prend en charge la découverte ou la résolution des problèmes, 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 le travail status. Cette propriété est héritée de CIM_Job.

JobType

Type de données : uint16

Type d'accès : Lecture seule

Type d’opération asynchrone suivie par cette instance de Msvm_StorageJob.

Inconnu (0)

Création de disque dur virtuel (1)

Création d’une image de disque dur virtuel (VHD).

Création de disquettes (2)

Création d’une image de disque de disquette virtuelle (VFD).

Compactage (3)

Compactage de la taille d’une image de disque dur virtuel.

Expansion (4)

Développer la taille d’une image de disque dur virtuel.

Fusion (5)

Fusion de plusieurs images de disque dur virtuel en une seule image.

Conversion (6)

Conversion du type d’une image de disque dur virtuel.

Montage bouclage (7)

Montage du disque dur virtuel sur la partition parente

Obtenir des informations sur le disque dur virtuel (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 CIM_Job.

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

L’utilisateur qui est averti en cas d’achèvement ou d’échec du travail. Cette propriété est héritée de CIM_Job.

OperatingStatus

Type de données : uint16

Type d'accès : Lecture seule

Fournit des informations status actuelles pour la condition opérationnelle de l’élément et peut être utilisée 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 : uint16 array

Type d'accès : Lecture seule

État actuel 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 du instance est 1 (Autre). Cette propriété est héritée de CIM_Job.

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 CIM_Job.

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 du fichier du 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 ), Units ( « Percent » )

Pourcentage d’achèvement du travail. Cette propriété est héritée de CIM_Job.

PrimaryStatus

Type de données : uint16

Type d'accès : Lecture seule

Fournit des informations de status de haut niveau. Cette propriété doit être utilisée conjointement avec la propriété DetailedStatus pour fournir un status d’intégrité de haut niveau 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 CIM_Job.

RecoveryAction

Type de données : uint16

Type d'accès : Lecture seule

Décrit l’action de récupération à effectuer pour un travail qui n’a pas été exécuté avec succès. Cette propriété est héritée de CIM_Job.

Inconnu (0)

Autre (1)

Ne pas continuer (2)

Continuer avec le travail suivant (3)

Réexécutez le travail (4)

Exécuter le travail 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 auquel le travail doit être traité. Il existe différentes interprétations pour cette propriété, en fonction de la valeur de RunDayOfWeek.

Lorsque RunDayOfWeek a la valeur 0 et que RunDay est positif, RunDay définit le jour du mois auquel la tâche est traitée. Par exemple, si RunDayOfWeek est 0 et RunDay est 12, le travail sera traité le 12ème jour du mois.

Lorsque RunDayOfWeek a la valeur 0 et que RunDay est négatif, RunDay définit le nombre de jours avant le dernier jour du mois sur lequel 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 0 et RunDay est 1, le travail sera traité le dernier jour du mois.

Lorsque RunDayOfWeek n’a pas la valeur 0, RunDayOfWeek est le jour de la semaine où le travail sera traité, par rapport à RunDay. Par exemple, si RunDay a la valeur 15 et RunDayOfWeek est 7 (+Saturday), le travail sera traité le premier samedi le15e jour du mois. Si RunDay est 20 et RunDayOfWeek est 7 ( samedi), le travail sera traité le premier samedi ou avant le 20ème jour du mois. Si RunDay a la valeur 1 et RunDayOfWeek est 1 (dimanche), le travail sera traité le dernier dimanche du mois.

Cette propriété est héritée de CIM_Job.

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 auquel le travail est traité. Pour plus d’informations, consultez la description de la propriété RunDay . Cette propriété est héritée de CIM_Job.

-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 CIM_Job.

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 où le travail doit être traité. Cette propriété est héritée de CIM_Job.

ScheduledStartTime

Type de données : datetime

Type d'accès : Lecture seule

Cette propriété est héritée de CIM_Job.

StartTime

Type de données : datetime

Type d'accès : Lecture seule

Heure à laquelle le travail a commencé. Cette propriété est héritée de CIM_Job.

É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 du 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 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 . La valeur par défaut est cinq minutes. Cette propriété est héritée de CIM_ConcreteJob et est toujours définie sur 0000000000005000.00000:000.

TimeOfLastStateChange

Type de données : datetime

Type d'accès : Lecture seule

Heure à laquelle l’état de la machine virtuelle a été modifié pour la dernière fois. Cette propriété est héritée de CIM_EnabledLogicalElement.

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 CIM_Job.

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 CIM_Job.

Notes

L’accès à la classe Msvm_StorageJob peut être limité par le filtrage de contrôle d’utilisateur. Pour plus d’informations, consultez Contrôle de compte d’utilisateur et WMI.

Spécifications

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\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Voir aussi

CIM_ConcreteJob

CIM_ConcreteJob

Classes de stockage