TaskFolder. RegisterTask, método

Para el scripting, registra (crea) una nueva tarea en la carpeta utilizando XML para definir la tarea.

Sintaxis

TaskFolder.RegisterTask( _
  ByVal path, _
  ByVal xmlText, _
  ByVal flags, _
  ByVal userId, _
  ByVal password, _
  ByVal logonType, _
  [ ByVal sddl ], _
  ByRef pTask _
)

Parámetros

ruta de acceso [ de]

Nombre de la tarea. Si este valor es Nothing, la tarea se registrará en la carpeta de tareas raíz y el nombre de la tarea será un valor GUID creado por el servicio Programador de tareas.

Un nombre de tarea no puede comenzar ni terminar con un carácter de espacio. No se puede usar el carácter '. ' para especificar la carpeta de tareas actual y '.. ' no se pueden usar caracteres para especificar la carpeta de tareas primaria en la ruta de acceso.

XmlText [ de]

Una descripción con formato XML de la tarea.

Los temas siguientes contienen tareas definidas mediante XML.

marcas [ de de]

Constante de _ creación de tareas .

Value Significado
Tarea _ de VALIDAR _ solo
0x1
El Programador de tareas comprueba la sintaxis del XML que describe la tarea, pero no registra la tarea. Esta constante no se puede combinar con la tarea _ crear, _ Actualizar tarea o _ crear _ o _ Actualizar valores.
Tarea _ de CREAR
0X2
El Programador de tareas registra la tarea como una nueva tarea.
Tarea _ de ACTUALIZAR
0x4
El Programador de tareas registra la tarea como una versión actualizada de una tarea existente. Cuando se actualiza una tarea con un desencadenador de registro, la tarea se ejecutará después de que se produzca la actualización.
Tarea _ de CREAR _ o _ Actualizar
0x6
El Programador de tareas registra la tarea como una nueva tarea o como una versión actualizada si la tarea ya existe. Equivalente a TASK _ Create | Task _ Update.
Tarea _ de Deshabilitar
0x8
El Programador de tareas deshabilita la tarea existente.
Tarea _ de No _ agregar _ entidad _
de seguridad principal
0x10
El Programador de tareas no puede Agregar la entrada de permiso de control de acceso (ACE) para la entidad de seguridad del contexto. Cuando se llama a la función TaskFolder. RegisterTask con esta marca para actualizar una tarea, el servicio Programador de tareas no agrega la ACE para la nueva entidad de seguridad de contexto y no quita la ACE de la entidad de seguridad de contexto anterior.
Tarea _ de OMITIr _ _ desencadenadores de registro
0x20
El Programador de tareas crea la tarea, pero omite los desencadenadores de registro de la tarea. Al omitir los desencadenadores de registro, la tarea no se ejecutará cuando se registre a menos que un desencadenador basado en el tiempo haga que se ejecute en el registro.

userId [ de]

Las credenciales de usuario que se usan para registrar la tarea.

Nota

Si la tarea se define como una tarea Programador de tareas 1,0, no use un nombre de grupo (en lugar de un nombre de usuario específico) en este parámetro userId. Una tarea se define como una tarea Programador de tareas 1,0 cuando el atributo version del elemento Task del XML de la tarea se establece en 1,1.

contraseña [ de de]

La contraseña de userId que se usa para registrar la tarea. Cuando se usa el tipo de inicio de sesión de la cuenta del servicio de inicio de sesión de tareas _ _ _ , la contraseña debe ser un valor Variant vacío como VT _ null o VT _ Empty.

logonType [ de]

Define la técnica de inicio de sesión que se utiliza para ejecutar la tarea registrada.

Value Significado
Tarea _ de LOGON _ ninguno
0
No se ha especificado el método Logon. Se usa para las credenciales que no son NT.
Tarea _ de _Contraseña de inicio de sesión
1
Use una contraseña para iniciar sesión en el usuario. La contraseña debe proporcionarse en el momento del registro.
Tarea _ de Inicio de sesión _ S4U
2
Use un token interactivo existente para ejecutar una tarea. El usuario debe iniciar sesión con un inicio de sesión de servicio para el usuario (S4U). Cuando se usa un inicio de sesión de S4U, el sistema no almacena ninguna contraseña y no hay acceso a la red ni a los archivos cifrados.
Tarea _ de _ _ Token interactivo de inicio de sesión
3
El usuario ya debe haber iniciado sesión. La tarea se ejecutará solo en una sesión interactiva existente.
Tarea _ de _Grupo de inicio de sesión
4
Activación de grupos. El campo GROUPID especifica el grupo.
Tarea _ de _ _ Cuenta de servicio de inicio de sesión
5
Indica que se utiliza un sistema local, servicio local o cuenta de servicio de red como contexto de seguridad para ejecutar la tarea.
Tarea _ de _Token interactivo _ de inicio _ de sesión o _ contraseña
6
En primer lugar, use el token interactivo. Si el usuario no ha iniciado sesión (no hay ningún token interactivo disponible), se usa la contraseña. La contraseña debe especificarse cuando se registra una tarea. Esta marca no se recomienda para las nuevas tareas porque es menos confiable que la contraseña de inicio de sesión de la tarea _ _ .

SDDL [ en, opcional]

Descriptor de seguridad asociado a la tarea registrada. Puede especificar la lista de control de acceso (ACL) en el descriptor de seguridad de una tarea con el fin de permitir o denegar el acceso de determinados usuarios y grupos a una tarea.

Nota

Si se deniega el acceso a la cuenta de sistema local a una tarea, el servicio de Programador de tareas puede generar resultados inesperados.

pTask [ enuncia]

Objeto RegisteredTask que representa la nueva tarea.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

En el caso de una tarea que contenga una acción de cuadro de mensaje, se mostrará el cuadro de mensaje si la tarea está activada y la tarea tiene un tipo de inicio de sesión interactivo. Para establecer el tipo de inicio de sesión de tarea en interactivo, especifique 3 (_ _ _ token interactivo de inicio de sesión de tarea) o 4 (_ _ grupo de inicio de sesión de tareas) en la propiedad LogonType de la entidad de seguridad de la tarea, o en el parámetro LogonType de TaskFolder. RegisterTask o TaskFolder. RegisterTaskDefinition.

Solo un miembro del grupo administradores puede crear una tarea con un desencadenador de arranque.

Puede registrar correctamente una tarea con un grupo especificado en el parámetro userId y 3 (_ _ _ símbolo interactivo de inicio de sesión de tarea) especificado en el parámetro LogonType de TaskFolder. RegisterTask o TaskFolder. RegisterTaskDefinition, pero la tarea no se ejecutará.

Requisitos

Requisito Value
Cliente mínimo compatible
Solo aplicaciones de escritorio de Windows Vista []
Servidor mínimo compatible
Solo aplicaciones de escritorio de Windows Server 2008 []
Biblioteca de tipos
Taskschd. tlb
Archivo DLL
Taskschd.dll

Vea también

Programador de tareas

RegisteredTask

TaskFolder