Msvm_StorageJob clase

Artículo
06/13/2023

Representa un trabajo de operación de almacenamiento creado por el servicio de administración de imágenes de Microsoft Hyper-V.

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

Sintaxis

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_StorageJob : CIM_ConcreteJob
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  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;
  string   Child;
  UINT32   JobCompletionStatusCode;
  string   Parent;
  uint16   JobType;
};

Miembros

La clase Msvm_StorageJob tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

La clase Msvm_StorageJob tiene estos métodos.

Método	Descripción
GetError	Recupera el error que describe el motivo por el que se produjo un error en el trabajo.
GetErrorEx	Cuando el trabajo se está ejecutando o ha finalizado sin error, este método no devuelve ninguna instancia de Msvm_Error . Sin embargo, si se ha producido un error en el trabajo debido a algún problema interno o porque un cliente ha terminado el trabajo, se devuelven una o varias instancias de Msvm_Error .
KillJob	No se admite este método.
RequestStateChange	Solicita un cambio de estado.

Propiedades

La clase Msvm_StorageJob 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 realice correctamente.

Caption

Tipo de datos: cadena
Tipo de acceso: solo lectura

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

Niño

Tipo de datos: cadena
Tipo de acceso: solo lectura

En caso de error de la operación asincrónica, esta propiedad contiene la ruta de acceso completa del elemento secundario del disco duro virtual afectado por esta operación.

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

Período de tiempo durante el que se ha estado ejecutando 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")

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

Identifica de forma única una instancia de esta clase. Esta propiedad se hereda de CIM_ManagedElement.

JobCompletionStatusCode

Tipo de datos: UINT32
Tipo de acceso: solo lectura

Código HRESULT que describe el estado de finalización de la operación asincrónica.

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

Estado operativo de un trabajo. También puede indicar transiciones entre estos estados, por ejemplo, 6 (apagar) y 3 (inicio). Esta propiedad se hereda de CIM_ConcreteJob.

Valor	Significado
Nuevo 2	El trabajo nunca se ha iniciado.
Starting (iniciándose) 3	El trabajo se mueve de los estados "Nuevo", "Suspendido" o "Servicio" al estado "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 "Completed", "Terminated" o "Killed".
Completado 7	El trabajo se ha completado normalmente.
Finalizado 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.

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

Tipo de operación asincrónica a la que realiza el seguimiento esta instancia de Msvm_StorageJob.

Desconocido (0)

Creación de VHD (1)

Creación de una imagen de disco duro virtual (VHD).

Creación de disquete (2)

Creación de una imagen de disco de disquete virtual (VFD).

Compactación (3)

Compactación del tamaño de una imagen de disco duro virtual.

Expansión (4)

Expandir el tamaño de una imagen de disco duro virtual.

Combinación (5)

Combinar varias imágenes de VHD en una sola imagen.

Conversión (6)

Convertir el tipo de una imagen de disco duro virtual.

Montaje de bucle invertido (7)

Montaje del disco duro virtual en la partición primaria

Obtener información de VHD (8)

Montaje del VHD en el sistema operativo de administración.

Validar imagen de disco duro virtual (9)

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

Etiqueta por la que se conoce el objeto. 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.

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

Propietario

Tipo de datos: cadena
Tipo de acceso: solo lectura

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

Parent

Tipo de datos: cadena
Tipo de acceso: solo lectura

Si se produce un error en la operación asincrónica, esta propiedad contiene la ruta de acceso del archivo al elemento primario del disco duro virtual afectado por esta operación.

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

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 )

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 antes del ú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 el 15^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 usado 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

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.

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 si se realiza correctamente o se produce un error 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 00000000000000500.000000:0000.

TimeOfLastStateChange

Tipo de datos: datetime
Tipo de acceso: solo lectura

Hora en la que se modificó por última vez el estado de la máquina virtual. Esta propiedad se hereda de CIM_EnabledLogicalElement.

TimeSubmitted

Tipo de datos: datetime
Tipo de acceso: solo lectura

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

Observaciones

El filtrado UAC puede restringir el acceso a la clase Msvm_StorageJob . Para obtener más información, consulte 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

Vea también

CIM_ConcreteJob
CIM_ConcreteJob
Clases de almacenamiento

Compartir a través de