Win32_ScheduledJob clase

  • Artículo

La Win32_ScheduledJobclase WMI representa un trabajo creado con el comando AT .

Nota

La clase Win32_ScheduledJob no representa un trabajo creado con el Asistente para tareas programadas del Panel de control. No se puede cambiar una tarea creada por WMI en la interfaz de usuario de tareas programadas. Para obtener más información, vea la sección Comentarios.

 

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades y los métodos están en orden alfabético, no en orden MOF.

Sintaxis

[Dynamic, Provider("CIMWin32"), UUID("{8502C4E0-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("Delete"), AMENDMENT]
class Win32_ScheduledJob : CIM_Job
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime ElapsedTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  datetime TimeSubmitted;
  datetime UntilTime;
  string   Command;
  uint32   DaysOfMonth;
  uint32   DaysOfWeek;
  boolean  InteractWithDesktop;
  uint32   JobId;
  string   JobStatus;
  boolean  RunRepeatedly;
  datetime StartTime;
};

Miembros

La clase Win32_ScheduledJob tiene estos tipos de miembros:

Métodos

La clase Win32_ScheduledJob tiene estos métodos.

Método Descripción
Crear Método de clase que envía un trabajo al sistema operativo para su ejecución en una fecha y hora futuras especificadas.
Eliminar Método de clase que elimina un trabajo programado.

 

Propiedades

La clase Win32_ScheduledJob tiene estas propiedades.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64), DisplayName ("Caption")

Descripción textual breve del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Comando

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de administración de redes | | AT_INFO Comando")

Nombre del comando, programa por lotes o archivo binario (y argumentos de línea de comandos) que el servicio de programación usa para invocar el trabajo.

Ejemplo: "defrag/q/f"

DaysOfMonth

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de administración de redes | | AT_INFO DaysOfMonth")

Días del mes en los que se programa la ejecución del trabajo. Si un trabajo está programado para ejecutarse en varios días del mes, estos valores se pueden combinar en una operación OR lógica. Por ejemplo, si un trabajo se va a ejecutar el 1 y el 16 de cada mes, el valor de la propiedad DaysOfMonth sería 1 O 32768.

1 (1)

1º

2 (2)

Segundo

3 (4)

3rd (tercero)

4 (8)

4.º

5 (16)

5.º

6 (32)

6.º

7 (64)

7.º

8 (128)

8.º

9 (256)

9.º

10 (512)

10º

11 (1024)

11°

12 (2048)

12°

13 (4096)

13°

14 (8192)

14º

15 (16384)

15º

16 (32768)

16º

17 (65536)

17º

18 (131072)

18º

19 (262144)

Xix

20 (524288)

Xx

21 (1048576)

21°

22 (2097152)

22°

23 (4194304)

23°

24 (8388608)

24º

25 (16777216)

25º

26 (33554432)

26º

27 (67108864)

27º

28 (134217728)

28º

29 (268435456)

29.

30 (536870912)

30.

31 (1073741824)

31.

DaysOfWeek

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de administración de red | | AT_INFO DaysOfWeek")

Días de la semana en los que se programa un trabajo para ejecutarse. Si un trabajo está programado para ejecutarse en varios días de la semana, los valores se pueden unir en un OR lógico. Por ejemplo, si un trabajo está programado para ejecutarse los lunes, miércoles y viernes, el valor de la propiedad DaysOfWeek sería 1 O 4 O 16.

Lunes (1)

Martes (2)

Miércoles (4)

Jueves (8)

Viernes (16)

Sábado (32)

Domingo (64)

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

ElapsedTime

Tipo de datos: datetime

Tipo de acceso: solo lectura

Tiempo durante el que se ha ejecutado el trabajo.

Esta propiedad se hereda de CIM_Job.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

InteractWithDesktop

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de administración de red | | AT_INFO Banderas|JOB_NONINTERACTIVE")

El trabajo especificado es interactivo, lo que significa que un usuario puede proporcionar entrada a un trabajo programado mientras se ejecuta.

JobId

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: Key, MappingStrings ("Win32API| Estructuras de administración de red | | AT_ENUM JobId")

Identificación del número del trabajo. Los métodos lo usan como identificador para un trabajo que se programa en este equipo.

Estado del trabajo

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Invalidación ("JobStatus"), MappingStrings ("Win32API| Estructuras de administración de red | | AT_ENUM Banderas|JOB_EXEC_ERROR")

Estado de ejecución la última vez que se programó este trabajo para ejecutarse.

Correcto ("Correcto")

Error ("Error")

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Name")

Etiqueta por la que se conoce el objeto. Cuando se subclase, esta propiedad se puede invalidar para que sea una propiedad de clave.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Notificar

Tipo de datos: cadena

Tipo de acceso: solo lectura

Se notifica al usuario tras la finalización o error del trabajo.

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.

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.

RunRepeatedly

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de administración de red | | AT_INFO Banderas|JOB_RUN_PERIODICALLY")

El trabajo programado se ejecuta repetidamente en los días que el trabajo está programado. Si es False, el trabajo se ejecuta una vez.

StartTime

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: Invalidación ("StartTime"), MappingStrings ("Win32API| Estructuras de administración de red | | AT_ENUM JobTime")

Hora UTC para ejecutar el trabajo, en forma de "AAAAMMDDHHMMSS. MMMMMM(+-)OOO", donde "AAAAMMDD" debe reemplazarse por "******". El reemplazo es necesario porque el servicio de programación solo permite que los trabajos se configuren para que se ejecuten una vez o se ejecuten en un día del mes o la semana. Un trabajo no se puede ejecutar en una fecha específica.

La sección "(+-)OOO" del valor de la propiedad StartTime es el sesgo actual para la traducción de hora local. El sesgo es la diferencia entre la hora UTC y la hora local. Para calcular el sesgo de la zona horaria, multiplique el número de horas que la zona horaria está por delante o detrás de la hora media de Greenwich (GMT) en 60 (use un número positivo para el número de horas si la zona horaria está por delante de GMT y un número negativo si la zona horaria está detrás de GMT). Agregue un adicional de 60 al cálculo si la zona horaria usa el horario de verano. Por ejemplo, la zona horaria estándar del Pacífico está ocho horas detrás de GMT, por lo que el sesgo es igual a -420 (-8 * 60 + 60) cuando el horario de verano está en uso y -480 (-8 * 60) cuando el horario de verano no está en uso. También puede determinar el valor del sesgo consultando la propiedad bias de la clase Win32_TimeZone .

Por ejemplo: "******123000.000000-420" especifica 14.30 (2:30 P.M.) PST con horario de verano en vigor.

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (10), DisplayName ("Status")

Cadena que indica el estado actual del objeto. Se puede definir el estado operativo y no operativo. El estado operativo puede incluir "Aceptar", "Degradado" y "Error previo". "Error previo" indica que un elemento funciona correctamente, pero predice un error (por ejemplo, una unidad de disco duro habilitada para SMART).

El estado no operativo puede incluir "Error", "Inicio", "Detención" y "Servicio". "Servicio" se puede aplicar durante el resilvering de reflejo del disco, volver a cargar una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "OK" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Pred Fail ("Pred Fail ")

Inicio ("Inicio")

Detención ("Detención ")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

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.

Comentarios

Cada trabajo programado en el servicio de programación se almacena de forma persistente (el programador puede iniciar un trabajo después de un reinicio) y se ejecuta en la hora y el día especificados de la semana o mes. Si el equipo no está activo o si el servicio programado no se está ejecutando en el tiempo de trabajo especificado, el servicio de programación ejecuta el trabajo especificado el día siguiente en la hora especificada.

Los trabajos se programan según la hora universal coordinada (UTC) con desplazamiento de sesgo de la hora media de Greenwich (GMT), lo que significa que se puede especificar un trabajo mediante cualquier zona horaria. La clase Win32_ScheduledJob devuelve la hora local con desplazamiento UTC al enumerar un objeto y se convierte en hora local al crear nuevos trabajos. Por ejemplo, un trabajo especificado para ejecutarse en un equipo de Boston a las 10:30 p.m. hora del lunes PST se programará para ejecutarse localmente a las 1:30 a.m. martes EST.

Nota

Un cliente debe tener en cuenta si el horario de verano está en funcionamiento o no en el equipo local y, si es así, resta un sesgo de 60 minutos del desplazamiento UTC.

 

La clase Win32_ScheduledJob se deriva de CIM_Job. Debe ser miembro del grupo de administradores para crear un trabajo programado mediante esta clase.

La clase Win32_ScheduledJob usa internamente el protocolo AT, que está enlazado a desuso a partir de Windows 8 y Windows Server 2012. Como primer paso, el protocolo AT está deshabilitado de forma predeterminada. Si el protocolo está deshabilitado, por ejemplo, si se llama al método Create en un objeto de Win32_ScheduledJob , se producirá un error 0x8. Puede volver a activar el protocolo AT agregando la siguiente entrada del Registro:

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Schedule\Configuration 
Name: EnableAt 
Type: REG_DWORD
Value: 1

Es posible que tenga que reiniciar la máquina para que la configuración sea efectiva.

Dado que Win32_ScheduledJob se basa en la API Win32 netScheduleJobGetInfo , no puede usar esta clase junto con el Programador de tareas. Si desea usar el Programador de tareas, use task Scheduler API. Para obtener más información, vea La referencia del programador de tareas.

Ejemplos

El siguiente ejemplo de código de VBScript programa Notepad.exe para que se ejecute de forma interactiva a las 1:25 por la hora del equipo local todos los miércoles.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set objNewJob = objWMIService.Get("Win32_ScheduledJob")
errJobCreated = objNewJob.Create("Notepad.exe", "********012500.000000-420", True , 4, , True, JobId) 
If errJobCreated <> 0 Then
Wscript.Echo "Error on task creation"
Else
Wscript.Echo "Task created"
End If

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista
Servidor mínimo compatible
 Windows Server 2008
Espacio de nombres
 Root\CIMV2
MOF
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

CIM_Job

Clases de sistema operativo

Tareas de WMI: tareas programadas