classe Msvm_MigrationJob

Articolo
06/12/2023

Questa classe rappresenta un processo di operazione di migrazione creato per la migrazione del sistema virtuale o di archiviazione dal servizio di migrazione del sistema virtuale.

La sintassi seguente è il codice MOF (Managed Object Format) semplificato e include tutte le proprietà ereditate.

Sintassi

[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;
};

Members

La classe Msvm_MigrationJob include questi tipi di membri:

Metodi
Proprietà

Metodi

La classe Msvm_MigrationJob include questi metodi.

Metodo	Descrizione
GetError	Recupera l'oggetto error per il processo di migrazione, se presente.
GetErrorEx	Recupera gli oggetti di errore per il processo di migrazione, se presente.
KillJob	Questo metodo non è supportato.
RequestStateChange	Richiede che lo stato del processo di migrazione venga modificato nello stato specificato.

Proprietà

La classe Msvm_MigrationJob include queste proprietà.

Annullabile

Tipo di dati: booleano
Tipo di accesso: sola lettura

Indica se il processo può essere annullato. Il valore di questa proprietà non garantisce che una richiesta di annullamento del processo avrà esito positivo.

Didascalia

Tipo di dati: stringa
Tipo di accesso: sola lettura

Breve descrizione dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

CommunicationStatus

Tipo di dati: uint16
Tipo di accesso: sola lettura

Indica la capacità della strumentazione di comunicare con l'elemento gestito sottostante. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

DeleteOnCompletion

Tipo di dati: booleano
Tipo di accesso: sola lettura

Specifica se il processo deve essere eliminato automaticamente al completamento. Questa proprietà viene ereditata da CIM_Job.

Descrizione

Tipo di dati: stringa
Tipo di accesso: sola lettura

Descrizione dell'oggetto . Questa proprietà viene ereditata da CIM_ManagedElement.

DestinationHost

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome host della piattaforma di virtualizzazione di destinazione in cui viene eseguita la migrazione del sistema virtuale. Questa operazione sarà Null per la migrazione dell'archiviazione.

DetailedStatus

Tipo di dati: uint16
Tipo di accesso: sola lettura

Complimenta la proprietà PrimaryStatus con dettagli di stato aggiuntivi. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

ElapsedTime

Tipo di dati: datetime
Tipo di accesso: sola lettura

Intervallo di tempo in cui il processo è stato eseguito o il tempo di esecuzione totale se il processo è stato completato. Questa proprietà viene ereditata da CIM_Job.

ElementName

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome visualizzato per l'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

ErrorCode

Tipo di dati: uint16
Tipo di accesso: sola lettura

Codice di errore specifico del fornitore. Il valore deve essere impostato su zero se il processo è stato completato senza errore. Questa proprietà viene ereditata da CIM_Job.

ErrorDescription

Tipo di dati: stringa
Tipo di accesso: sola lettura

Stringa contenente la descrizione dell'errore del fornitore. Questa proprietà viene ereditata da CIM_Job.

ErrorSummaryDescription

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: ModelCorrespondence ("CIM_Job. ErrorCode")

Descrizione di riepilogo dell'errore, se presente.

HealthState

Tipo di dati: uint16
Tipo di accesso: sola lettura

Integrità corrente dell'elemento. Questo attributo esprime l'integrità di questo elemento, ma non necessariamente quella dei relativi sottocomponenti. I valori possibili sono da 0 a 30, dove 5 significa che l'elemento è completamente integro e 30 significa che l'elemento è completamente non funzionante. Questa proprietà viene ereditata da CIM_ManagedSystemElement e viene sempre impostata su 5.

InstallDate

Tipo di dati: datetime
Tipo di accesso: sola lettura

Data e ora di creazione della configurazione della macchina virtuale. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InstanceID

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: Chiave

Identifica in modo univoco un'istanza di questa classe. Questa proprietà viene ereditata da CIM_ManagedElement e viene sempre impostata su Null.

JobRunTimes

Tipo di dati: uint32
Tipo di accesso: sola lettura

Numero di volte in cui deve essere eseguito il processo. Un valore pari a 1 indica che il processo non è ricorrente, mentre qualsiasi valore diverso da zero indica un limite al numero di volte in cui il processo verrà eseguito di nuovo. Zero indica che non esiste alcun limite al numero di volte in cui è possibile elaborare il processo, ma verrà terminato dopo il raggiungimento di UntilTime oppure il processo viene terminato manualmente. Questa proprietà viene ereditata da CIM_Job.

JobState

Tipo di dati: uint16
Tipo di accesso: sola lettura

JobState è un'enumerazione integer che indica lo stato operativo di un processo. Può anche indicare transizioni tra questi stati, ad esempio "Arresto" e "Avvio". Questa proprietà viene ereditata da CIM_ConcreteJob.

Valore	Significato
Nuovo 2	Il processo non è mai stato avviato.
Avvio in corso 3	Il processo viene spostato dallo stato 2 (Nuovo), 5(Sospeso) o 11 (Servizio) nello stato 4 (Esecuzione).
Running 4	Il processo è in esecuzione.
Sospeso 5	Il processo viene arrestato, ma può essere riavviato in modo semplice.
Arresto 6	Il processo viene spostato in uno stato 7 (Completato), 8 (Terminato) o 9 (Ucciso).
Operazione completata 7	Il processo è stato completato normalmente.
Terminato 8	Il processo è stato arrestato da una richiesta di modifica dello stato "Termina". Il processo e tutti i relativi processi sottostanti vengono terminati e possono essere riavviati solo come nuovo processo. Il requisito che il processo venga riavviato solo come nuovo processo è specifico del processo.
Killed 9	Il processo è stato arrestato da una richiesta di modifica dello stato "Kill". I processi sottostanti possono comunque essere in esecuzione e potrebbe essere necessario liberare risorse.
Eccezione 10	Il processo si trova in uno stato anomalo che potrebbe essere indicativo di una condizione di errore. Lo stato effettivo del processo potrebbe essere disponibile tramite oggetti specifici del processo.
Service 11	Il processo si trova in uno stato specifico del fornitore che supporta l'individuazione dei problemi o la risoluzione o entrambi.
DMTF riservato 12 32767	Riservato.
Fornitore riservato 32768 65535	Riservato.

Stato processo

Tipo di dati: stringa
Tipo di accesso: sola lettura

Stringa che rappresenta lo stato del processo. Questa proprietà viene ereditata da CIM_Job.

JobType

Tipo di dati: uint16
Tipo di accesso: sola lettura

Indica il tipo di processo monitorato da questo oggetto.

Sconosciuto (0)

Creazione di macchine virtuali remote (300)

Verifica della compatibilità delle macchine virtuali (301)

Verifica della compatibilità delle macchine virtuali e dell'archiviazione (302)

Verifica della compatibilità dell'archiviazione (303)

Controllo della migrazione dell'archiviazione (304)

Spostamento della macchina virtuale (305)

Spostamento di macchine virtuali e archiviazione (306)

Spostamento dello spazio di archiviazione (307)

LocalOrUtcTime

Tipo di dati: uint16
Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_Job.

Indica se i tempi rappresentati nelle proprietà RunStartInterval e UntilTime rappresentano orari locali o ore UTC.

Ora locale (1)
Ora UTC (2 )

MigrationType

Tipo di dati: uint16
Tipo di accesso: sola lettura
Qualificatori: ModelCorrespondence ("Msvm_VirtualSystemMigrationSettingData. MigrationType")

Tipo di migrazione rappresentato da questo oggetto processo. Questo sarà uno dei valori definiti per la proprietà MigrationType della classe Msvm_VirtualSystemMigrationSettingData .

Nome

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: Key, MaxLen ( 256 )

Nome visualizzato per questa istanza di un processo. Inoltre, il nome visualizzato può essere usato come proprietà per una ricerca o una query. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

NewResourceSettingData

Tipo di dati: matrice di stringhe
Tipo di accesso: sola lettura

Per una migrazione in tempo reale, questo valore verrà sempre impostato su Null.

Per una migrazione di archiviazione, se è Null, nessuno dei dischi rigidi virtuali della macchina virtuale verrà spostato. In caso contrario, conterrà una matrice di istanze incorporate della classe Msvm_StorageAllocationSettingData che rappresentano i dischi rigidi virtuali da spostare. La proprietà Connection di queste istanze specifica il percorso di destinazione del disco rigido virtuale.

NewSystemSettingData

Tipo di dati: string
Tipo di accesso: sola lettura

Per una migrazione in tempo reale, questo valore verrà sempre impostato su Null.

Per una migrazione dell'archiviazione, se è Null, le radici dei dati della macchina virtuale non vengono spostate. In caso contrario, conterrà un'istanza incorporata della classe Msvm_VirtualSystemSettingData , in cui le proprietà ExternalDataRoot, SnapshotDataRoot e SwapFileDataRoot specificano le nuove radici dei dati.

Notificare

Tipo di dati: string
Tipo di accesso: sola lettura

L'utente che riceve una notifica al completamento o all'esito negativo del processo. Questa proprietà viene ereditata da CIM_Job.

OperatingStatus

Tipo di dati: uint16
Tipo di accesso: sola lettura

Fornisce informazioni sullo stato correnti per la condizione operativa dell'elemento e può essere utilizzata per fornire maggiori dettagli rispetto al valore della proprietà EnabledState . Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

OperationalStatus

Tipo di dati: matrice uint16
Tipo di accesso: sola lettura

Stati correnti dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement e ogni elemento della matrice è sempre impostato su 2 (OK).

OtherRecoveryAction

Tipo di dati: string
Tipo di accesso: sola lettura

Stringa che descrive l'azione di ripristino quando la proprietà RecoveryAction dell'istanza è 1 (Altro). Questa proprietà viene ereditata da CIM_Job.

Proprietario

Tipo di dati: string
Tipo di accesso: sola lettura

Utente che ha inviato il processo. Questa proprietà viene ereditata da CIM_Job.

PercentComplete

Tipo di dati: uint16
Tipo di accesso: sola lettura
Qualificatori: MinValue ( 0 ), MaxValue ( 100 ), Unità ( "Percent" )

Percentuale di completamento del processo. Questa proprietà viene ereditata da CIM_Job.

PrimaryStatus

Tipo di dati: uint16
Tipo di accesso: sola lettura

Fornisce informazioni generali sullo stato. Questa proprietà deve essere utilizzata insieme alla proprietà DetailedStatus per fornire lo stato di integrità generale e dettagliato dell'elemento e dei relativi sottocomponenti. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Priorità

Tipo di dati: uint32
Tipo di accesso: sola lettura

Importanza dell'esecuzione di un processo. Questa proprietà viene ereditata da CIM_Job.

RecoveryAction

Tipo di dati: uint16
Tipo di accesso: sola lettura

Descrive l'azione di ripristino da eseguire per un processo di esecuzione non riuscita. Questa proprietà viene ereditata da CIM_Job.

Sconosciuto (0)
Altro (1)
Non continuare (2)
Continuare con il processo successivo (3)
Riesegui processo (4)
Eseguire il processo di ripristino (5 )

RunDay

Tipo di dati: sint8
Tipo di accesso: sola lettura
Qualificatori: MinValue ( -31 ), MaxValue ( 31 )

Giorno del mese in cui deve essere elaborato il processo. Per questa proprietà sono disponibili interpretazioni diverse, a seconda del valore di RunDayOfWeek.

Quando RunDayOfWeek è 0 e RunDay è positivo, RunDay definisce il giorno del mese in cui viene elaborato il processo. Ad esempio, se RunDayOfWeek è 0 e RunDay è 12, il processo verrà elaborato il 12^° giorno del mese.

Quando RunDayOfWeek è 0 e RunDay è negativo, RunDay definisce il numero di giorni prima dell'ultimo giorno del mese in cui viene elaborato il processo. 1 indica l'ultimo giorno del mese, 2 indica un giorno prima dell'ultimo giorno del mese e così via. Ad esempio, se RunDayOfWeek è 0 e RunDay è 1, il processo verrà elaborato l'ultimo giorno del mese.

Quando RunDayOfWeek non è 0, RunDayOfWeek è il giorno della settimana in cui verrà elaborato il processo, relativo a RunDay. Ad esempio, se RunDay è 15 e RunDayOfWeek è 7 (+Sabato), il processo verrà elaborato il primo sabato o dopo il 15^° giorno del mese. Se RunDay è 20 e RunDayOfWeek è 7 ( sabato), il processo verrà elaborato il primo sabato o prima del 20^° giorno del mese. Se RunDay è 1 e RunDayOfWeek è 1 ( domenica), il processo verrà elaborato l'ultima domenica del mese.

Questa proprietà viene ereditata da CIM_Job.

RunDayOfWeek

Tipo di dati: sint8
Tipo di accesso: sola lettura

Intero positivo o negativo utilizzato insieme a RunDay per indicare il giorno della settimana o del mese in cui viene elaborato il processo. Per altre informazioni, vedere la descrizione della proprietà RunDay . Questa proprietà viene ereditata da CIM_Job.

-Saturday ( 7)
-Friday ( 6)
-Giovedì ( 5)
-Mercoledì ( 4)
-Martedì ( 3)
-Monday ( 2)
-Domenica ( 1)
ExactDayOfMonth (0)
Domenica (1)
Lunedì (2)
Martedì (3)
Mercoledì (4)
Giovedì (5)
Venerdì (6)
Sabato (7 )

RunMonth

Tipo di dati: uint8
Tipo di accesso: sola lettura

Mese durante il quale deve essere elaborato il processo. Questa proprietà viene ereditata da CIM_Job.

Gennaio (0)
Febbraio (1)
Marzo (2)
Aprile (3)
Maggio (4)
Giugno (5)
Luglio (6)
Agosto (7)
Settembre (8)
Ottobre (9)
Novembre (10)
Dicembre (11 )

RunStartInterval

Tipo di dati: datetime
Tipo di accesso: sola lettura

Intervallo di tempo dopo la mezzanotte in cui deve essere elaborato il processo. Questa proprietà viene ereditata da CIM_Job.

ScheduledStartTime

Tipo di dati: datetime
Tipo di accesso: sola lettura

Ora di inizio pianificata per il processo, se applicabile. Questa proprietà viene ereditata da CIM_Job.

StartTime

Tipo di dati: datetime
Tipo di accesso: sola lettura

Ora di inizio del processo. Questa proprietà viene ereditata da CIM_Job.

Status

Tipo di dati: string
Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_ManagedSystemElement, ma non viene utilizzata.

StatusDescriptions

Tipo di dati: matrice di stringhe
Tipo di accesso: sola lettura

Stringhe che descrivono i vari valori della matrice OperationalStatus . Questa proprietà viene ereditata da CIM_ManagedSystemElement e ogni elemento della matrice è sempre impostato su "OK".

TimeBeforeRemoval

Tipo di dati: datetime
Tipo di accesso: sola lettura

Intervallo di tempo, espresso in minuti, in cui il processo viene conservato al termine dell'esecuzione, operazione riuscita o non riuscita nell'esecuzione. Il processo deve rimanere presente per un certo periodo di tempo indipendentemente dal valore della proprietà DeleteOnCompletion . Il valore predefinito è 5 minuti. Questa proprietà viene ereditata da CIM_ConcreteJob e viene sempre impostata su 000000000000500.000000:000.

TimeOfLastStateChange

Tipo di dati: datetime
Tipo di accesso: sola lettura

Data o ora dell'ultima modifica dello stato del processo. Se lo stato del processo non è stato modificato e questa proprietà viene popolata, deve essere impostata su un valore di intervallo 0. Se è stata richiesta una modifica dello stato, ma rifiutata o non ancora elaborata, la proprietà non deve essere aggiornata. Questa proprietà viene ereditata da CIM_ConcreteJob.

TimeSubmitted

Tipo di dati: datetime
Tipo di accesso: sola lettura

Ora di invio del processo. Questa proprietà viene ereditata da CIM_Job.

UntilTime

Tipo di dati: datetime
Tipo di accesso: sola lettura

Ora in cui il processo non è valido o deve essere arrestato. Questa proprietà viene ereditata da CIM_Job.

VirtualSystemName

Tipo di dati: string
Tipo di accesso: sola lettura

Nome univoco del sistema virtuale interessato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Spazio dei nomi	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Condividi tramite