Crear método de la clase Win32_ScheduledJob

El método de clase CreateWMI envía un trabajo a un sistema operativo para su ejecución en una fecha y hora especificadas en el futuro. Este método requiere que el servicio de programación se inicie en el equipo al que se envía el trabajo.

En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.

Sintaxis

uint32 Create(
  [in]           string   Command,
  [in]           datetime StartTime,
  [in, optional] boolean  RunRepeatedly,
  [in, optional] uint32   DaysOfWeek,
  [in, optional] uint32   DaysOfMonth,
  [in, optional] boolean  InteractWithDesktop,
  [out]          uint32   JobId
);

Parámetros

Comando [in]

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

Ejemplo: "defrag /q /f".

StartTime [in]

Hora universal coordinada (UTC) para ejecutar un trabajo. El formulario debe ser: "AAAAMMDDHHMMSS. MMMMMM(+-)OOO", donde "AAAAMMDD" debe reemplazarse por "******". Por ejemplo: "******143000.000000-420" especifica 14.30 (2:30 P.M.) PST con horario de verano en vigor.

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

RunRepeatedly [in, optional]

Si es True, un trabajo programado se ejecuta repetidamente en días específicos. El valor predeterminado es False.

DaysOfWeek [in, opcional]

Días de la semana en los que un trabajo está programado para ejecutarse; se usa solo cuando el parámetro RunRepeatedly es True. Para programar un trabajo durante más de un día de la semana, únase a los valores adecuados en un or lógico. Por ejemplo, para programar un trabajo para martes y viernes, el valor de DaysOfWeek es 2 O 16.

Lunes (1)

Martes (2)

Miércoles (4)

Jueves (8)

Viernes (16)

Sábado (32)

Domingo (64)

DaysOfMonth [in, opcional]

Días del mes en que se programa la ejecución de un trabajo; se usa solo cuando el parámetro RunRepeatedly es True.

1 (1)

Día 1 de un mes

2 (2)

Día 2 de un mes

3 (4)

Día 3 de un mes

4 (8)

Día 4 de un mes

5 (16)

Día 5 de un mes

6 (32)

Día 6 de un mes

7 (64)

Día 7 de un mes

8 (128)

Día 8 de un mes

9 (256)

Día 9 de un mes

10 (512)

Día 10 de un mes

11 (1024)

Día 11 de un mes

12 (2048)

Día 12 de un mes

13 (4096)

Día 13 de un mes

14 (8192)

Día 14 de un mes

15 (16384)

Día 15 de un mes

16 (32768)

Día 16 de un mes

17 (65536)

Día 17 de un mes

18 (131072)

Día 18 de un mes

19 (262144)

Día 19 de un mes

20 (524288)

Día 20 de un mes

21 (1048576)

Día 21 de un mes

22 (2097152)

Día 22 de un mes

23 (4194304)

Día 23 de un mes

24 (8388608)

Día 24 de un mes

25 (16777216)

Día 25 de un mes

26 (33554432)

Día 26 de un mes

27 (67108864)

Día 27 de un mes

28 (134217728)

Día 28 de un mes

29 (268435456)

Día 29 de un mes

30 (536870912)

Día 30 de un mes

31 (1073741824)

Día 31 de un mes

InteractWithDesktop [in, opcional]

Si es True, el trabajo especificado debe ser interactivo, lo que significa que un usuario puede proporcionar una entrada a un trabajo programado mientras se ejecuta el trabajo. El valor predeterminado es False.

JobId [out]

Número de identificador de un trabajo. Este parámetro es un identificador de un trabajo programado en un equipo.

Valor devuelto

Devuelve un valor de 0 (cero) cuando se ejecuta correctamente y un número diferente para indicar un error. Para obtener códigos de error adicionales, consulte Constantes de error WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

Finalización correcta

0

Se acepta la solicitud.

No compatible

1

No se admite la solicitud.

Acceso denegado

2

El usuario no tiene el acceso necesario.

Error desconocido

8

Proceso interactivo.

No se encuentra la ruta de acceso

9

No se encuentra la ruta de acceso del directorio al archivo ejecutable del servicio.

Parámetro no válido

21

Se han pasado parámetros no válidos al servicio.

Servicio no iniciado

22

La cuenta en la que se ejecuta este servicio no es válida o carece de los permisos para ejecutar el servicio.

Otros

23 4294967295

Comentarios

Si el trabajo programado inicia un programa interactivo como el Bloc de notas, la propiedad InteractWithDeskto debe establecerse en True o la pantalla del programa no está visible. El proceso sigue apareciendo en el Administrador de tareas aunque no aparezca en la pantalla.

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

Clases de sistema operativo

Win32_ScheduledJob