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

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	Taskschd.tlb
Archivo DLL	Taskschd.dll

Consulte también

Programador de tareas

TaskDefinition

NetworkSettings

IdleSettings