Msvm_ConcreteJob clase

Artículo
06/13/2023

Una versión concreta del trabajo. Esta clase representa una unidad de trabajo genérica y crea instancias, como un lote o un trabajo de impresión, y se usa específicamente en Hyper-V para realizar un seguimiento del progreso de las operaciones asincrónicas.

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_ConcreteJob : 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;
  string   ErrorSummaryDescription;
  uint16   RecoveryAction;
  string   OtherRecoveryAction;
  uint16   JobState;
  datetime TimeOfLastStateChange;
  datetime TimeBeforeRemoval = 
                00000000000500.000000:000
              ;
  boolean  Cancellable;
  uint16   JobType;
};

Miembros

La clase Msvm_ConcreteJob tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

La clase Msvm_ConcreteJob tiene estos métodos.

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

Propiedades

La clase Msvm_ConcreteJob 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.

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. Esta propiedad se hereda de CIM_Job.

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

Valor	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 con normalidad.
Finalizado 8	La solicitud de cambio de estado "Terminate" ha detenido el trabajo. 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 requiera 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 reservado 12 32767	Reservado.
Proveedor reservado 32768 65535	Reservado.

Estado del trabajo

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)

Definir máquina virtual (1)

Modificar máquina virtual (2)

Destruir máquina virtual (3)

Modificar la configuración del servicio de administración (4)

Inicializar máquina virtual (10)

Esperando a iniciar la máquina virtual (11)

Iniciar máquina virtual (12)

Apagar máquina virtual (13)

Guardar máquina virtual (14)

Restaurar máquina virtual (15)

Apagar máquina virtual (16)

Pausar máquina virtual (26)

Reanudar máquina virtual (27)

Restablecer máquina virtual (28)

Reiniciar máquina virtual (29)

Agregar recursos de máquina virtual (30)

Modificar recursos de máquina virtual (31)

Eliminación de recursos de máquina virtual (32)

Solicitar memoria de máquina virtual inicial (40)

Agregar memoria a la máquina virtual (41)

Quitar memoria de la máquina virtual (42)

Combinación de discos VHD (50)

Creación de una instantánea de VSS dentro de la máquina virtual (51)

Obtener datos de configuración de importación (60)

Importar máquina virtual (61)

Exportar máquina virtual (62)

Configuración de registro (63)

Anular el registro de la configuración (64)

Máquina virtual de instantáneas (70)

Aplicar instantánea de máquina virtual (71)

Eliminar instantánea de máquina virtual (72)

Borrar estado de instantánea de máquina virtual (73)

Agregar recursos al grupo de recursos (80)

Eliminación de recursos del grupo de recursos (81)

Modificar la configuración del servidor de replicación (90)

Crear relación de replicación (91)

Modificar la configuración de la relación de replicación (92)

Quitar relación de replicación (93)

Iniciar replicación inicial de banda (94)

Replicación de importación (95)

Cambio de estado de replicación (96)

Iniciar conmutación por error (97)

Revertir conmutación por error (98)

Conmutación por error de confirmación (99)

Iniciar replicación sincronizada (100)

Cancelar la replicación sincronizada (101)

Iniciar réplica de prueba (102)

Quitar réplica de prueba (103)

Replicación inversa (104)

Delta de envío de replicación (105)

Delta de recepción de replicación (106)

Resincronización (107)

Aplicar registro de cambios (108)

Detener la replicación inicial (109)

Detener resincronización (110)

Obtener estadísticas de réplica (111)

Preparar el Comprobador de coherencia (112)

Comprobador de coherencia (113)

Detener comprobador de coherencia (114)

Probar la conexión de replicación (115)

Envío de réplica inicial (116)

Iniciar la replicación inicial de resincronización (117)

Iniciar la exportación de la replicación inicial (118)

Restablecer estadísticas de réplica (119)

Aplicar deltas registrados (120)

Resincronización de la replicación extendida (121)

Lectura de la configuración de réplica de prueba (122)

Cambiar el modo de replicación a principal (123)

Iniciar conmutación por recuperación (124)

Actualizar conjunto de discos (125)

Nota

Valor agregado en Windows 10.

Definir conmutador Ethernet (130)

Modificar la configuración del conmutador Ethernet (131)

Destruir conmutador Ethernet (132)

Agregar recursos de conmutador Ethernet (133)

Modificar recursos del conmutador Ethernet (134)

Quitar recursos de conmutador Ethernet (135)

Validar la máquina virtual planeada (140)

Realización de una máquina virtual (141)

Creación de un grupo de recursos (150)

Cambiar los recursos primarios de un grupo de recursos (151)

Cambiar la configuración de no asignación de un grupo de recursos (152)

Eliminación de un grupo de recursos (153)

Habilitación de la GPU de RemoteFx (160)

Deshabilitación de la GPU de RemoteFx (161)

Modificar la configuración del servicio 3D (162)

Nota

Valor agregado en Windows 10.

Máquina virtual de copia de seguridad (170)

Interfaz de servicio invitado (180)

Nota

Valor agregado en Windows 10.

Consultar información del clúster invitado (181)

Nota

Valor agregado en Windows 10.

Definir colección (190)

Nota

Valor agregado en Windows 10.

Destroy Collection (191)

Nota

Valor agregado en Windows 10.

Cambiar nombre de colección (192)

Nota

Valor agregado en Windows 10.

Agregar miembro a la colección (193)

Nota

Valor agregado en Windows 10.

Quitar miembro de la colección (194)

Nota

Valor agregado en Windows 10.

Agregar configuración a la colección (195)

Nota

Valor agregado en Windows 10.

Quitar la configuración de la colección (196)

Nota

Valor agregado en Windows 10.

Modificar la configuración en la colección (197)

Nota

Valor agregado en Windows 10.

Colección de instantáneas (198)

Nota

Valor agregado en Windows 10.

Convertir instantánea en punto de referencia (200)

Nota

Valor agregado en Windows 10.

Crear punto de referencia (201)

Nota

Valor agregado en Windows 10.

Eliminar punto de referencia (202)

Nota

Valor agregado en Windows 10.

Punto de referencia de exportación (203)

Nota

Valor agregado en Windows 10.

Quitar datos asociados del punto de referencia (204)

Nota

Valor agregado en Windows 10.

Crear punto de referencia en la colección (205)

Nota

Valor agregado en Windows 10.

Exportar punto de referencia en la colección (206)

Nota

Valor agregado en Windows 10.

Quitar datos asociados del punto de referencia de la colección (207)

Nota

Valor agregado en Windows 10.

Eliminar punto de referencia en la colección (208)

Nota

Valor agregado en Windows 10.

Importar metadatos del punto de referencia (209)

Nota

Valor agregado en Windows 10 como punto de referencia de limpieza.

Montaje o desmontaje de un dispositivo asignable (260)

Nota

Valor agregado en Windows 10.

LocalOrUtcTime

Tipo de datos: uint16
Tipo de acceso: solo lectura

Indica si las horas representadas en las propiedades RunStartInterval y UntilTime representan las horas locales o las horas UTC. Esta propiedad se hereda de CIM_Job.

Hora local (1)
Hora UTC (2 )

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.

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 se debe usar 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 que no se ejecutó correctamente. 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.

Comentarios

El acceso a la clase Msvm_ConcreteJob puede estar restringido por el filtrado de UAC. Para obtener más información, vea Control de cuentas de usuario y WMI.

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

Consulte también

CIM_ConcreteJob
CIM_ConcreteJob
Clases de administración de sistemas virtuales

Compartir a través de

Msvm_ConcreteJob clase

Sintaxis

Miembros

Métodos

Propiedades

Comentarios

Requisitos

Consulte también

Comentarios

Recursos adicionales