MSVM _ MigrationJob, classe

Cette classe représente un travail d’opération de migration créé pour le stockage ou la migration du système virtuel par le service de migration de système virtuel.

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_MigrationJob : CIM_ConcreteJob
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  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;
  uint16   RecoveryAction;
  string   OtherRecoveryAction;
  uint16   JobState;
  datetime TimeOfLastStateChange;
  datetime TimeBeforeRemoval = 00000000000500.000000:000;
  boolean  Cancellable;
  string   ErrorSummaryDescription;
  uint16   MigrationType;
  string   VirtualSystemName;
  string   DestinationHost;
  string   NewSystemSettingData;
  string   NewResourceSettingData[];
  uint16   JobType;
};

Membres

La classe MSVM _ MigrationJob possède les types de membres suivants :

Méthodes

La classe MSVM _ MigrationJob possède ces méthodes.

Méthode Description
GetError Récupère l’objet d’erreur pour la tâche de migration, s’il en existe une.
GetErrorEx Récupère les objets d’erreur pour la tâche de migration, le cas échéant.
KillJob Cette méthode n'est pas prise en charge.
RequestStateChange Demande que l’état de la tâche de migration passe à l’état spécifié.

Propriétés

La classe MSVM _ MigrationJob 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.

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.

DestinationHost

Type de données : chaîne

Type d'accès : Lecture seule

Nom d’hôte de la plateforme de virtualisation de destination vers laquelle le système virtuel migre. Il s’agit d’une valeur null pour la migration du stockage.

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

Intervalle de temps pendant lequel le travail s’est exécuté, ou durée totale d’exécution si le travail est terminé. 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.

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

Qualificateurs : clé

Identifie de façon unique une instance de cette classe. Cette propriété est héritée de CIM _ propriété ManagedElementet est toujours définie sur null.

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

JobState est une énumération entière qui indique l’état opérationnel d’un travail. Il peut également indiquer des transitions entre ces États, par exemple « arrêt » et « démarrage ». 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 2 (nouveau), 5 (suspendu) ou 11 (service) à l’État 4 (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 à un État 7 (terminé), 8 (terminé) ou 9 (abattu).
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

Indique le type de travail faisant l’objet d’un suivi par cet objet.

Inconnu (0)

Création d’une machine virtuelle distante (300)

Vérification de la compatibilité des machines virtuelles (301)

vérification de la compatibilité des ordinateurs virtuels et des Stockage (302)

vérification de la compatibilité des Stockage (303)

vérification de la Migration de Stockage (304)

Déplacement de la machine virtuelle (305)

déplacement d’une Machine virtuelle et d’un Stockage (306)

déplacement de Stockage (307)

LocalOrUtcTime

Type de données : UInt16

Type d'accès : Lecture seule

Cette propriété est héritée de la _ tâche CIM.

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

Heure locale (1)

Heure UTC (2)

MigrationType

Type de données : UInt16

Type d'accès : Lecture seule

Qualificateurs : ModelCorrespondence ("MSVM _ VirtualSystemMigrationSettingData.MigrationType")

Type de migration représenté par cet objet de traitement. Il s’agira de l’une des valeurs définies pour la propriété MigrationType de la classe MSVM _ VirtualSystemMigrationSettingData .

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé, MaxLen (256)

Nom complet de cette instance d’un travail. En outre, le nom complet peut être utilisé en tant que propriété pour une recherche ou une requête. Cette propriété est héritée de CIM _ ManagedSystemElement.

NewResourceSettingData

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Pour une migration dynamique, elle est toujours définie sur null.

Pour une migration de stockage, si la valeur est null, aucun disque dur virtuel (VHD) de la machine virtuelle ne sera déplacé. Sinon, elle contient un tableau d’instances incorporées de la classe MSVM _ StorageAllocationSettingData qui représentent les disques durs virtuels à déplacer. La propriété de connexion de ces instances spécifie l’emplacement de destination du disque dur virtuel.

NewSystemSettingData

Type de données : chaîne

Type d'accès : Lecture seule

Pour une migration dynamique, elle est toujours définie sur null.

Pour une migration de stockage, si la valeur est null, les racines de données de l’ordinateur virtuel ne sont pas déplacées. Sinon, elle contient une instance incorporée de la classe MSVM _ VirtualSystemSettingData , où les propriétés ExternalDataRoot, SnapshotDataRoot et SwapFileDataRoot spécifient les nouvelles racines de données.

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, et chaque élément de tableau a toujours la valeur 2 (OK).

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.

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 réussi à s’exécuter. 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

Heure de début planifiée pour le travail, le cas échéant. 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, et chaque élément de tableau est toujours défini sur « OK ».

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

Date ou heure de la dernière modification de l’état du travail. Si l’état de la tâche n’a pas changé et que cette propriété est remplie, elle doit être définie sur une valeur d’intervalle 0. Si une modification d’État a été demandée, mais rejetée ou n’a pas encore été traitée, la propriété ne doit pas être mise à jour. Cette propriété est héritée de la _ ConcreteJob 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.

VirtualSystemName

Type de données : chaîne

Type d'accès : Lecture seule

Nom unique du système virtuel affecté.

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
WindowsVirtualization. v2. mof
DLL
Vmms.exe