RegisteredTask (objeto)

Objeto de scripting que proporciona los métodos que se usan para ejecutar la tarea inmediatamente, obtiene las instancias en ejecución de la tarea, obtiene o establece las credenciales que se usan para registrar la tarea y las propiedades que describen la tarea.

Miembros

El objeto RegisteredTask tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

El objeto RegisteredTask tiene estos métodos.

Método	Descripción
GetInstances	Devuelve todas las instancias de la tarea registrada que se están ejecutando actualmente.
GetRunTimes	Obtiene las horas en que se programa la tarea registrada para ejecutarse durante un tiempo especificado.
GetSecurityDescriptor	Obtiene el descriptor de seguridad que se usa como credenciales para la tarea registrada.
Ejecutar	Ejecuta la tarea registrada inmediatamente.
RunEx	Ejecuta la tarea registrada inmediatamente con marcas especificadas y un identificador de sesión.
SetSecurityDescriptor	Establece el descriptor de seguridad que se usa como credenciales para la tarea registrada.
Parada	Detiene la tarea registrada inmediatamente.

Propiedades

El objeto RegisteredTask tiene estas propiedades.

Propiedad	Tipo de acceso	Descripción
Definición	Solo lectura	Obtiene la definición de la tarea.
Enabled	Lectura/escritura	Obtiene o establece un valor booleano que indica si la tarea registrada está habilitada.
LastRunTime	Solo lectura	Obtiene la hora en que se ejecutó por última vez la tarea registrada.
LastTaskResult	Solo lectura	Obtiene los resultados que se devolvieron la última vez que se ejecutó la tarea registrada.
Nombre	Solo lectura	Obtiene el nombre de la tarea registrada.
NextRunTime	Solo lectura	Obtiene la hora a la que se programa la ejecución de la tarea registrada.
NumberOfMissedRuns	Solo lectura	Obtiene el número de veces que la tarea registrada ha perdido una ejecución programada.
Ruta de acceso	Solo lectura	Obtiene la ruta de acceso a donde se almacena la tarea registrada.
State	Solo lectura	Obtiene el estado operativo de la tarea registrada.
XML	Solo lectura	Obtiene la información de registro con formato XML para la tarea registrada.

Ejemplos

Para obtener más información y código de ejemplo para este objeto de scripting, vea Ejemplo de desencadenador de hora (scripting) y Mostrar nombres y estados de tarea (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