classe CIM_Job (gestion Hyper-V)

Article
08/19/2023

É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
Propriétés

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

Partager via

classe CIM_Job (gestion Hyper-V)

Syntaxe

Membres

Méthodes

Propriétés

Configuration requise

Voir aussi

Commentaires

Ressources supplémentaires