classe CIM_Job (gestion Hyper-V)

  • Article

Élément logique qui représente une unité de travail à exécuter, comme un script ou un travail d’impression. Un travail est distinct d’un processus, car un travail peut être planifié ou mis en file d’attente et son exécution n’est pas limitée à un seul système.

Syntaxe

[Abstract, Version("2.10.0"), UMLPackagePath("CIM::Core::CoreElements"), AMENDMENT]
class CIM_Job : CIM_LogicalElement
{
  string   JobStatus;
  datetime TimeSubmitted;
  datetime ScheduledStartTime;
  datetime StartTime;
  datetime ElapsedTime;
  uint32   JobRunTimes = 1;
  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;
  uint16   RecoveryAction;
  string   OtherRecoveryAction;
};

Membres

La classe CIM_Job a les types de membres suivants :

Méthodes

La classe CIM_Job a ces méthodes.

Méthode Description
KillJob Cette méthode est déconseillée. Utilisez plutôt la méthode RequestStateChange .
Note: Description déconseillée : arrête un travail.

Propriétés

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

DeleteOnCompletion

Type de données : booléen

Type d’accès : lecture/écriture

True pour supprimer le travail à l’achèvement ; sinon, false.

Notes

Cette propriété ne supprime pas les travaux qui se terminent avant que cette propriété ne soit définie sur True.

Heure écoulée

Type de données : DateHeure

Type d'accès : Lecture seule

Durée pendant laquelle le travail a été exécuté.

ErrorCode

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_Job.ErrorDescription »)

Code d’erreur propre au fournisseur qui capture les informations de traitement pour les travaux périodiques. La valeur doit être définie sur zéro si le travail s’est terminé sans erreur.

ErrorDescription

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_Job.ErrorCode »)

Chaîne de forme libre qui contient une description du code d’erreur correspondant dans la propriété ErrorCode .

JobRunTimes

Type de données : uint32

Type d’accès : lecture/écriture

Nombre de fois où exécuter le travail.

JobStatus

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_ManagedSystemElement.OperationalStatus »)

Chaîne de forme libre qui représente le status du travail.

LocalOrUtcTime

Type de données : uint16

Type d’accès : lecture/écriture

Indique si les heures des propriétés RunStartInterval et UntilTime représentent des heures locales ou des heures UTC.

Heure locale (1)

Heure UTC (2)

Notifier

Type de données : chaîne

Type d'accès : lecture/écriture

L’utilisateur doit avertir lorsqu’un travail se termine ou échoue.

OtherRecoveryAction

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_Job.RecoveryAction »)

Chaîne qui décrit l’action de récupération lorsque la propriété RecoveryAction a la valeur Other (« 1 »).

Propriétaire

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_OwningJobElement. »)

L’utilisateur qui a envoyé le travail, ou le nom du service ou de la méthode qui a demandé le travail.

PercentComplete

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : Units (« Percent »), MinValue (0), MaxValue (101), PUnit (« Percent »)

Pourcentage du travail terminé.

Notes

La valeur « 101 » n’est pas définie et ne sera pas autorisée dans la prochaine révision majeure de la spécification.

Priorité

Type de données : uint32

Type d’accès : lecture/écriture

L’importance du travail. Plus le numéro est faible, plus la priorité est élevée.

RecoveryAction

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence (« CIM_Job.OtherRecoveryAction »)

Décrit l’action de récupération à effectuer en cas d’échec d’un travail d’exécution.

Inconnu (0)

On ne sait pas quelle action de récupération prendre.

Autre (1)

L’action de récupération sera spécifiée dans la propriété OtherRecoveryAction .

Ne pas continuer (2)

Arrêtez l’exécution du travail 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écutez le travail (4)

Le travail doit être réexécuté.

Exécuter le travail de récupération (5)

Exécutez le travail associé à l’aide de la relation RecoveryJob . Notez que le travail de récupération doit déjà se trouver dans la file d’attente à partir de laquelle il s’exécutera.

RunDay

Type de données : sint8

Type d’accès : lecture/écriture

Qualificateurs : MinValue (-31), MaxValue (31), ModelCorrespondence (« CIM_Job.RunMonth », « CIM_Job. RunDayOfWeek », « CIM_Job. RunStartInterval »)

Entier utilisé conjointement avec la propriété RunDayOfWeek pour indiquer le jour où le travail est traité ; ou, si RunDayOfWeek est défini sur zéro, RunDay indique le jour du mois où le travail est traité. Si RunDay est un entier négatif, il spécifie un jour par rapport à la fin du mois, ou si RunDay est un entier positif, il spécifie un jour relatif au début du mois.

RunDayOfWeek

Type de données : sint8

Type d’accès : lecture/écriture

Qualificateurs : ModelCorrespondence (« CIM_Job.RunMonth », « CIM_Job. RunDay », « CIM_Job. RunStartInterval »)

Entier utilisé conjointement avec la propriété RunDay pour indiquer le jour où le travail est traité ; ou, si RunDayOfWeek est défini sur zéro, RunDay indique le jour du mois où le travail est traité.

-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/écriture

Qualificateurs : ModelCorrespondence (« CIM_Job.RunDay », « CIM_Job. RunDayOfWeek », « CIM_Job. RunStartInterval »)

Mois où le travail est traité.

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 : DateHeure

Type d’accès : lecture/écriture

Qualificateurs : ModelCorrespondence (« CIM_Job.RunMonth », « CIM_Job. RunDay », « CIM_Job. RunDayOfWeek », « CIM_Job. RunStartInterval »)

Intervalle de temps après minuit où le travail est traité. Par exemple, « 00000000020000.00000:0000: 0000 » indique que le travail est exécuté à ou après deux heures locales, ou heure UTC (UTC est spécifié avec la propriété LocalOrUtcTime ).

ScheduledStartTime

Type de données : DateHeure

Type d’accès : lecture/écriture

Qualificateurs : déconseillé (« CIM_Job.RunMonth », « CIM_Job. RunDay », « CIM_Job. RunDayOfWeek », « CIM_Job. RunStartInterval »)

Notes

Cette propriété est déconseillée. Au lieu de cela, nous vous recommandons d’utiliser les propriétés RunMonth, RunDay, RunDayOfWeek et RunStartInterval.

Heure à laquelle le travail actuel est planifié pour démarrer. Cette heure peut être représentée par une date et une heure, ou un intervalle par rapport à l’heure à laquelle la propriété est demandée. Une valeur de tous les zéros indique que le travail est déjà en cours d’exécution.

StartTime

Type de données : DateHeure

Type d'accès : Lecture seule

Heure à laquelle le travail a démarré. Cette heure peut être représentée par une date et une heure, ou par un intervalle par rapport à l’heure à laquelle la propriété est demandée.

TimeSubmitted

Type de données : DateHeure

Type d'accès : Lecture seule

Heure à laquelle le travail a été soumis. Une valeur de tous les zéros indique que l’élément parent n’est pas capable de signaler une date et une heure.

UntilTime

Type de données : DateHeure

Type d’accès : lecture/écriture

Qualificateurs : ModelCorrespondence (« CIM_Job.LocalOrUtcTime »)

Heure après laquelle le travail devient non valide ou doit être arrêté. L’heure peut être représentée par une date et une heure, ou par un intervalle relatif à l’heure à laquelle cette propriété est demandée. La valeur des neuf indique que le travail peut s’exécuter indéfiniment.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
 Windows 8
Serveur minimal pris en charge
 Windows Server 2012
Espace de noms
 Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Voir aussi

CIM_LogicalElement