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.
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
);
-
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.
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
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.
Requisito | Value |
---|---|
Cliente mínimo compatible |
Windows Vista |
Servidor mínimo compatible |
Windows Server 2008 |
Espacio de nombres |
Root\CIMV2 |
MOF |
|
Archivo DLL |
|