Msvm_MigrationJob clase

Artículo
01/28/2024

Esta clase representa un trabajo de operación de migración creado para la migración del sistema virtual o de almacenamiento mediante el servicio de migración del sistema virtual.

La sintaxis siguiente es código de Formato de objeto administrado (MOF) simplificado e incluye todas las propiedades heredadas.

Sintaxis

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

Miembros

La clase Msvm_MigrationJob tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

La clase Msvm_MigrationJob tiene estos métodos.

Método	Descripción
GetError	Recupera el objeto de error del trabajo de migración, si existe uno.
GetErrorEx	Recupera los objetos de error del trabajo de migración, si existe alguno.
KillJob	No se admite este método.
RequestStateChange	Solicita que el estado del trabajo de migración se cambie al estado especificado.

Propiedades

La clase Msvm_MigrationJob tiene estas propiedades.

Cancelable

Tipo de datos: booleano
Tipo de acceso: solo lectura

Indica si se puede cancelar el trabajo. El valor de esta propiedad no garantiza que una solicitud para cancelar el trabajo se realizará correctamente.

Caption

Tipo de datos: cadena
Tipo de acceso: solo lectura

Descripción breve del objeto. Esta propiedad se hereda de CIM_ManagedElement.

CommunicationStatus

Tipo de datos: uint16
Tipo de acceso: solo lectura

Indica la capacidad de la instrumentación para comunicarse con el elemento administrado subyacente. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

DeleteOnCompletion

Tipo de datos: booleano
Tipo de acceso: solo lectura

Especifica si el trabajo se debe eliminar automáticamente tras la finalización. Esta propiedad se hereda de CIM_Job.

Descripción

Tipo de datos: cadena
Tipo de acceso: solo lectura

Descripción del objeto. Esta propiedad se hereda de CIM_ManagedElement.

DestinationHost

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre de host de la plataforma de virtualización de destino a la que está migrando el sistema virtual. Será Null para la migración de almacenamiento.

DetailedStatus

Tipo de datos: uint16
Tipo de acceso: solo lectura

Complementa la propiedad PrimaryStatus con detalles de estado adicionales. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

ElapsedTime

Tipo de datos: datetime
Tipo de acceso: solo lectura

Intervalo de tiempo que el trabajo ha estado ejecutando o el tiempo de ejecución total si se ha completado el trabajo. Esta propiedad se hereda de CIM_Job.

ElementName

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre para mostrar del objeto. Esta propiedad se hereda de CIM_ManagedElement.

ErrorCode

Tipo de datos: uint16
Tipo de acceso: solo lectura

Código de error específico del proveedor. El valor debe establecerse en cero si el trabajo se completó sin error. Esta propiedad se hereda de CIM_Job.

ErrorDescription

Tipo de datos: cadena
Tipo de acceso: solo lectura

Cadena que contiene la descripción del error del proveedor. Esta propiedad se hereda de CIM_Job.

ErrorSummaryDescription

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: ModelCorrespondence ("CIM_Job. ErrorCode")

Una descripción resumida del error, si está presente.

HealthState

Tipo de datos: uint16
Tipo de acceso: solo lectura

Estado actual del elemento. Este atributo expresa el estado de este elemento, pero no necesariamente el de sus subcomponentes. Los valores posibles son de 0 a 30, donde 5 significa que el elemento es completamente correcto y 30 significa que el elemento no funciona completamente. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en 5.

InstallDate

Tipo de datos: datetime
Tipo de acceso: solo lectura

Fecha y hora en que se creó la configuración de la máquina virtual. Esta propiedad se hereda de CIM_ManagedSystemElement.

InstanceID

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Clave

Identifica de forma única una instancia de esta clase. Esta propiedad se hereda de CIM_ManagedElement y siempre se establece en Null.

JobRunTimes

Tipo de datos: uint32
Tipo de acceso: solo lectura

Número de veces que se debe ejecutar el trabajo. Un valor de 1 indica que el trabajo no es periódico, mientras que cualquier valor distinto de cero indica un límite para el número de veces que se repetirá el trabajo. Cero indica que no hay ningún límite en el número de veces que se puede procesar el trabajo, pero se finalizará después de que se haya alcanzado untilTime o el trabajo se finalice manualmente. Esta propiedad se hereda de CIM_Job.

JobState

Tipo de datos: uint16
Tipo de acceso: solo lectura

JobState es una enumeración entera que indica el estado operativo de un trabajo. También puede indicar transiciones entre estos estados, por ejemplo, "Apagar" y "Iniciar". Esta propiedad se hereda de CIM_ConcreteJob.

Value	Significado
Nuevo 2	El trabajo nunca se ha iniciado.
Starting (iniciándose) 3	El trabajo pasa de los estados 2 (nuevo), 5 (suspendido) o 11 (servicio) al estado 4 (en ejecución).
Ejecución 4	El trabajo se está ejecutando.
Suspendido 5	El trabajo se detiene, pero se puede reiniciar sin problemas.
Cerrando 6	El trabajo se mueve a un estado 7 (completado), 8 (finalizado) o 9 (muerto).
Completado 7	El trabajo se ha completado normalmente.
Terminado 8	El trabajo se ha detenido mediante una solicitud de cambio de estado "Finalizar". El trabajo y todos sus procesos subyacentes se finalizan y solo se pueden reiniciar como un nuevo trabajo. El requisito de que el trabajo se reinicie solo como un nuevo trabajo es específico del trabajo.
Killed 9	El trabajo se ha detenido mediante una solicitud de cambio de estado "Kill". Es posible que los procesos subyacentes sigan en ejecución y que se necesite una limpieza para liberar recursos.
Exception 10	El trabajo está en un estado anómalo que podría ser indicativo de una condición de error. El estado real del trabajo puede estar disponible a través de objetos específicos del trabajo.
Servicio 11	El trabajo está en un estado específico del proveedor que admite la detección o resolución de problemas, o ambos.
DMTF Reserved 12 32767	Reservado.
Proveedor reservado 32768 65535	Reservado.

JobStatus

Tipo de datos: cadena
Tipo de acceso: solo lectura

Cadena que representa el estado del trabajo. Esta propiedad se hereda de CIM_Job.

JobType

Tipo de datos: uint16
Tipo de acceso: solo lectura

Indica el tipo de trabajo al que realiza el seguimiento este objeto.

Desconocido (0)

Creación de una máquina virtual remota (300)

Comprobación de la compatibilidad de máquinas virtuales (301)

Comprobación de la compatibilidad de máquinas virtuales y Storage (302)

Comprobación de la compatibilidad de Storage (303)

Comprobación de la migración de Storage (304)

Mover máquina virtual (305)

Mover máquina virtual y Storage (306)

Mover Storage (307)

LocalOrUtcTime

Tipo de datos: uint16
Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_Job.

Indica si las horas representadas en las propiedades RunStartInterval y UntilTime representan las horas locales o las horas UTC.

Hora local (1)
Hora UTC (2 )

MigrationType

Tipo de datos: uint16
Tipo de acceso: solo lectura
Calificadores: ModelCorrespondence ("Msvm_VirtualSystemMigrationSettingData. MigrationType")

Tipo de migración representado por este objeto de trabajo. Se trata de uno de los valores definidos para la propiedad MigrationType de la clase Msvm_VirtualSystemMigrationSettingData .

Nombre

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Key, MaxLen ( 256 )

Nombre para mostrar de esta instancia de un trabajo. Además, el nombre para mostrar se puede usar como una propiedad para una búsqueda o consulta. Esta propiedad se hereda de CIM_ManagedSystemElement.

NewResourceSettingData

Tipo de datos: matriz de cadenas
Tipo de acceso: solo lectura

Para una migración en vivo, siempre se establecerá en Null.

Para una migración de almacenamiento, si es Null, no se moverá ninguno de los discos duros virtuales (VHD) de la máquina virtual. De lo contrario, contendrá una matriz de instancias incrustadas de la clase Msvm_StorageAllocationSettingData que representa los VHD que se van a mover. La propiedad Connection de estas instancias especificará la ubicación de destino del disco duro virtual.

NewSystemSettingData

Tipo de datos: cadena
Tipo de acceso: solo lectura

Para una migración en vivo, siempre se establecerá en Null.

Para una migración de almacenamiento, si es Null, las raíces de datos de la máquina virtual no se mueven. De lo contrario, contendrá una instancia insertada de la clase Msvm_VirtualSystemSettingData , donde las propiedades ExternalDataRoot, SnapshotDataRoot y SwapFileDataRoot especificarán las nuevas raíces de datos.

Notificar

Tipo de datos: cadena
Tipo de acceso: solo lectura

El usuario que recibe una notificación tras la finalización o error del trabajo. Esta propiedad se hereda de CIM_Job.

OperatingStatus

Tipo de datos: uint16
Tipo de acceso: solo lectura

Proporciona información de estado actual para la condición operativa del elemento y se puede usar para proporcionar más detalles con respecto al valor de la propiedad EnabledState . Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

OperationalStatus

Tipo de datos: matriz uint16
Tipo de acceso: solo lectura

Estados actuales del objeto . Esta propiedad se hereda de CIM_ManagedSystemElement y cada elemento de matriz siempre se establece en 2 (OK).

OtherRecoveryAction

Tipo de datos: cadena
Tipo de acceso: solo lectura

Cadena que describe la acción de recuperación cuando la propiedad RecoveryAction de la instancia es 1 (Otros). Esta propiedad se hereda de CIM_Job.

Propietario

Tipo de datos: cadena
Tipo de acceso: solo lectura

El usuario que envió el trabajo. Esta propiedad se hereda de CIM_Job.

PercentComplete

Tipo de datos: uint16
Tipo de acceso: solo lectura
Calificadores: MinValue ( 0 ), MaxValue ( 100 ), Units ( "Percent" )

Porcentaje de finalización del trabajo. Esta propiedad se hereda de CIM_Job.

PrimaryStatus

Tipo de datos: uint16
Tipo de acceso: solo lectura

Proporciona información de estado de alto nivel. Esta propiedad debe usarse junto con la propiedad DetailedStatus para proporcionar un estado de mantenimiento alto y detallado del elemento y sus subcomponentes. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

Prioridad

Tipo de datos: uint32
Tipo de acceso: solo lectura

La importancia de la ejecución de un trabajo. Esta propiedad se hereda de CIM_Job.

RecoveryAction

Tipo de datos: uint16
Tipo de acceso: solo lectura

Describe la acción de recuperación que se va a realizar para un trabajo de ejecución incorrecta. Esta propiedad se hereda de CIM_Job.

Desconocido (0)
Otros (1)
No continuar (2)
Continuar con el siguiente trabajo (3)
Volver a ejecutar el trabajo (4)
Ejecutar trabajo de recuperación (5 )

RunDay

Tipo de datos: sint8
Tipo de acceso: solo lectura
Calificadores: MinValue ( -31 ), MaxValue ( 31 )

El día del mes en el que se debe procesar el trabajo. Hay diferentes interpretaciones para esta propiedad, según el valor de RunDayOfWeek.

Cuando RunDayOfWeek es 0 y RunDay es positivo, RunDay define el día del mes en el que se procesa el trabajo. Por ejemplo, si RunDayOfWeek es 0 y RunDay es 12, el trabajo se procesará el día ^{12 del} mes.

Cuando RunDayOfWeek es 0 y RunDay es negativo, RunDay define el número de días anteriores al último día del mes en el que se procesa el trabajo. 1 indica el último día del mes, 2 indica un día antes del último día del mes, etc. Por ejemplo, si RunDayOfWeek es 0 y RunDay es 1, el trabajo se procesará el último día del mes.

Cuando RunDayOfWeek no es 0, RunDayOfWeek es el día de la semana en que se procesará el trabajo, en relación con RunDay. Por ejemplo, si RunDay es 15 y RunDayOfWeek es 7 (+sábado), el trabajo se procesará el primer sábado o después del día ^{15 del} mes. Si RunDay es 20 y RunDayOfWeek es 7 ( sábado), el trabajo se procesará el primer sábado o antes del día ^{20 del} mes. Si RunDay es 1 y RunDayOfWeek es 1 ( domingo), el trabajo se procesará el último domingo del mes.

Esta propiedad se hereda de CIM_Job.

RunDayOfWeek

Tipo de datos: sint8
Tipo de acceso: solo lectura

Entero positivo o negativo que se usa junto con RunDay para indicar el día de la semana o el mes en el que se procesa el trabajo. Consulte la descripción de la propiedad RunDay para obtener más información. Esta propiedad se hereda de CIM_Job.

-Sábado ( 7)
-Viernes ( 6)
-Jueves ( 5)
-Miércoles ( 4)
-Martes ( 3)
-Lunes ( 2)
-Domingo ( 1)
ExactDayOfMonth (0)
Domingo (1)
Lunes (2)
Martes (3)
Miércoles (4)
Jueves (5)
Viernes (6)
Sábado (7 )

RunMonth

Tipo de datos: uint8
Tipo de acceso: solo lectura

Mes durante el que se debe procesar el trabajo. Esta propiedad se hereda de CIM_Job.

Enero (0)
Febrero (1)
Marzo (2)
Abril (3)
Mayo (4)
Junio (5)
Julio (6)
Agosto (7)
Septiembre (8)
Octubre (9)
Noviembre (10)
Diciembre (11 )

RunStartInterval

Tipo de datos: datetime
Tipo de acceso: solo lectura

Intervalo de tiempo después de medianoche cuando se debe procesar el trabajo. Esta propiedad se hereda de CIM_Job.

ScheduledStartTime

Tipo de datos: datetime
Tipo de acceso: solo lectura

Hora de inicio programada para el trabajo, si procede. Esta propiedad se hereda de CIM_Job.

StartTime

Tipo de datos: datetime
Tipo de acceso: solo lectura

Hora a la que comenzó el trabajo. Esta propiedad se hereda de CIM_Job.

Estado

Tipo de datos: cadena
Tipo de acceso: solo lectura

Esta propiedad se hereda de CIM_ManagedSystemElement, pero no se usa.

StatusDescriptions

Tipo de datos: matriz de cadenas
Tipo de acceso: solo lectura

Cadenas que describen los distintos valores de matriz OperationalStatus . Esta propiedad se hereda de CIM_ManagedSystemElement y cada elemento de matriz siempre se establece en "Ok".

TimeBeforeRemoval

Tipo de datos: datetime
Tipo de acceso: solo lectura

Cantidad de tiempo, en minutos, que el trabajo se conserva después de que haya terminado de ejecutarse, ya sea correctamente o con errores en esa ejecución. El trabajo debe permanecer en existencia durante algún período de tiempo, independientemente del valor de la propiedad DeleteOnCompletion . El valor predeterminado es cinco minutos. Esta propiedad se hereda de CIM_ConcreteJob y siempre se establece en 000000000000500.000000:0000.000.

TimeOfLastStateChange

Tipo de datos: datetime
Tipo de acceso: solo lectura

Fecha u hora en que el estado del trabajo cambió por última vez. Si el estado del trabajo no ha cambiado y esta propiedad se rellena, debe establecerse en un valor de intervalo 0. Si se solicitó un cambio de estado, pero se rechazó o aún no se procesó, la propiedad no se debe actualizar. Esta propiedad se hereda de CIM_ConcreteJob.

TimeSubmitted

Tipo de datos: datetime
Tipo de acceso: solo lectura

Hora a la que se envió el trabajo. Esta propiedad se hereda de CIM_Job.

UntilTime

Tipo de datos: datetime
Tipo de acceso: solo lectura

Hora en la que el trabajo no es válido o se debe detener. Esta propiedad se hereda de CIM_Job.

VirtualSystemName

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre único del sistema virtual afectado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Espacio de nombres	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
Archivo DLL	Vmms.exe

Compartir a través de