Msvm_MigrationJob classe

Article
06/12/2023

Cette classe représente une tâche d’opération de migration créée pour la migration du stockage ou du système virtuel par le service de migration de système virtuel.

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

Méthodes
Propriétés

Méthodes

La classe Msvm_MigrationJob a ces méthodes.

Méthode	Description
GetError	Récupère l’objet d’erreur pour le travail de migration, le cas échéant.
GetErrorEx	Récupère les objets d’erreur pour le travail de migration, le cas échéant.
KillJob	Cette méthode n'est pas prise en charge.
RequestStateChange	Demande que l’état du travail de migration soit remplacé par l’état spécifié.

Propriétés

La classe Msvm_MigrationJob a 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.

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é à l’achèvement. 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.

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. Cette valeur est 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 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.

ElapsedTime

Type de données : datetime
Type d'accès : Lecture seule

Intervalle de temps pendant lequel le travail a été exécuté, ou durée totale d’exécution si le travail est terminé. Cette propriété est héritée de CIM_Job.

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

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 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
Qualificateurs : Clé

Identifie de manière unique un instance de cette classe. Cette propriété est héritée de CIM_ManagedElement et est toujours définie sur Null.

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

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

Valeur	Signification
Nouveau 2	Le travail n’a jamais commencé.
Démarrage en cours 3	Le travail passe des états 2 (Nouveau), 5(Suspendu) ou 11 (Service) à l’état 4 (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 7 (Terminé), 8 (Terminé) ou 9 (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

Indique le type de travail 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 machines virtuelles et du stockage (302)

Vérification de la compatibilité du stockage (303)

Vérification de la migration du stockage (304)

Déplacement d’une machine virtuelle (305)

Déplacement d’une machine virtuelle et d’un stockage (306)

Déplacement du stockage (307)

LocalOrUtcTime

Type de données : uint16
Type d'accès : Lecture seule

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

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 travail. Il s’agit 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 : Key, MaxLen ( 256 )

Nom complet de cette instance d’un travail. En outre, le nom complet peut être utilisé comme 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, cette valeur est toujours définie sur Null.

Pour une migration de stockage, s’il s’agit de la valeur Null, aucun disque dur virtuel de la machine virtuelle n’est déplacé. Sinon, cela contiendra un tableau d’instances incorporées de la classe Msvm_StorageAllocationSettingData qui représentent les disques durs virtuels à déplacer. La propriété Connection 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, cette valeur est toujours définie sur Null.

Pour une migration de stockage, si cette valeur est Null, les racines de données de la machine virtuelle ne se déplacent pas. Sinon, cela contiendra une instance incorporée de la classe Msvm_VirtualSystemSettingData, où les propriétés ExternalDataRoot, SnapshotDataRoot et SwapFileDataRoot spécifieront les nouvelles racines de données.

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, et chaque élément de tableau est toujours défini sur 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 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.

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 à entreprendre pour un travail qui n’a pas réussi à s’exécuter. 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 le^15e 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

Heure de début planifiée du travail, le cas échéant. 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, 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 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

Date ou heure de la dernière modification de l’état du travail. Si l’état du travail 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 pas encore traitée, la propriété ne doit pas être mise à jour. Cette propriété est héritée de CIM_ConcreteJob.

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.

VirtualSystemName

Type de données : chaîne
Type d'accès : Lecture seule

Nom unique du système virtuel affecté.

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

Partager via