TaskSettings (objeto)
Objeto de scripting que proporciona la configuración que usa el servicio Programador de tareas para realizar la tarea.
Miembros
El objeto TaskSettings tiene estos tipos de miembros:
Propiedades
El objeto TaskSettings tiene estas propiedades.
| Propiedad | Tipo de acceso | Descripción |
|---|---|---|
|
AllowDemandStart |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que la tarea se puede iniciar mediante el comando Ejecutar o el menú Contextual. |
|
AllowHardTerminate |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que la tarea se puede finalizar mediante TerminateProcess. |
|
Compatibilidad |
Lectura/escritura |
Obtiene o establece un valor entero que indica con qué versión del Programador de tareas es compatible una tarea. |
|
DeleteExpiredTaskAfter |
Lectura/escritura |
Obtiene o establece la cantidad de tiempo que el Programador de tareas esperará antes de eliminar la tarea después de que expire. |
|
DisallowStartIfOnBatteries |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que la tarea no se iniciará si el equipo se está ejecutando con batería. |
|
habilitado |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que la tarea está habilitada. La tarea solo se puede realizar cuando esta configuración es True. |
|
ExecutionTimeLimit |
Lectura/escritura |
Obtiene o establece la cantidad de tiempo permitido para completar la tarea. |
|
Hidden |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que la tarea no estará visible en la interfaz de usuario. Sin embargo, los administradores pueden invalidar esta configuración mediante el uso de un "conmutador maestro" que hace que todas las tareas sean visibles en la interfaz de usuario. |
|
IdleSettings |
Lectura/escritura |
Obtiene o establece la información que especifica cómo realiza el Programador de tareas las tareas cuando el equipo está en un estado inactivo. |
|
MultipleInstances |
Lectura/escritura |
Obtiene o establece la directiva que define cómo trabaja el Programador de tareas con varias instancias de la tarea. |
|
NetworkSettings |
Lectura/escritura |
Obtiene o establece el objeto de configuración de red que contiene un identificador y un nombre de perfil de red. Si la propiedad RunOnlyIfNetworkAvailable de TaskSettings es True y se especifica un propfile de red en la propiedad NetworkSettings , la tarea se ejecutará solo si el perfil de red especificado está disponible. |
|
Priority |
Lectura/escritura |
Obtiene o establece el nivel de prioridad de la tarea. |
|
RestartCount |
Lectura/escritura |
Obtiene o establece el número de veces que el Programador de tareas intentará reiniciar la tarea. |
|
RestartInterval |
Lectura/escritura |
Obtiene o establece un valor que especifica cuánto tiempo intentará reiniciar la tarea el Programador de tareas. |
|
RunOnlyIfIdle |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que el Programador de tareas ejecutará la tarea solo si el equipo está en estado inactivo. |
|
RunOnlyIfNetworkAvailable |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que el Programador de tareas ejecutará la tarea solo cuando haya una red disponible. |
|
StartWhenAvailable |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que el Programador de tareas puede iniciar la tarea en cualquier momento después de que haya transcurrido su hora programada. |
|
StopIfGoingOnBatteries |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que la tarea se detendrá si el equipo comienza a ejecutarse con batería. |
|
WakeToRun |
Lectura/escritura |
Obtiene o establece un valor booleano que indica que el Programador de tareas reactivará el equipo cuando sea el momento de ejecutar la tarea. |
|
Xmltext |
Lectura/escritura |
Obtiene o establece una definición con formato XML de la configuración de la tarea. |
Comentarios
De forma predeterminada, una tarea se detendrá 72 horas después de empezar a ejecutarse. Para cambiar esto, cambie la configuración ExecutionTimeLimit .
Al leer o escribir XML para una tarea, la configuración de la tarea se define en el elemento Settings del esquema del Programador de tareas.
Ejemplos
Para obtener más información y un ejemplo de código para este objeto de scripting, vea Ejemplo de desencadenador de hora (scripting) .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Biblioteca de tipos |
|
| Archivo DLL |
|