Método Create de la clase _ ScheduledJob de Win32

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

En este tema se usa Managed Object Format sintaxis MOF (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 [ En]

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 [ En]

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

La sección "(+-)OOO" del valor de la propiedad StartTime es el sesgo actual para la traducción de la 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 por detrás de la hora media de Greenwich (GMT) por 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 60 adicionales 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 por 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 _ TimeZone de Win32.

RunRepeatedly [ en, opcional]

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

DaysOfWeek [ en, opcional]

Días de la semana en los que se programa la ejecución de un trabajo; se usa solo cuando el parámetro RunRepeatedly es True. Para programar un trabajo durante más de un día de la semana, una 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 [ en, 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 [ en, opcional]

Si es True, el trabajo especificado debe ser interactivo, lo que significa que un usuario puede dar 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 que se programa en un equipo.

Valor devuelto

Devuelve un valor de 0 (cero) cuando se realiza correctamente y un número diferente para indicar un error. Para obtener códigos de error adicionales, vea Wmi Error Constants o WbemErrorEnum. Para obtener valores HRESULT generales, vea Códigos de error del sistema.

Completado correctamente.

0

Se acepta la solicitud.

No admitido

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 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 incluso si no aparece en la pantalla.

Requisitos

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

Vea también

Clases de sistema operativo

ScheduledJob de Win32 _