Compartir a través de


Principal (objeto)

Objeto de scripting que proporciona las credenciales de seguridad de una entidad de seguridad. Estas credenciales de seguridad definen el contexto de seguridad de las tareas asociadas a la entidad de seguridad.

Miembros

El objeto Principal tiene estos tipos de miembros:

Propiedades

El objeto Principal tiene estas propiedades.

Propiedad Tipo de acceso Descripción
DisplayName
Lectura/escritura
Obtiene o establece el nombre de la entidad de seguridad que se muestra en la interfaz de usuario del programador de tareas.
Groupid
Lectura/escritura
Obtiene o establece el identificador del grupo de usuarios necesario para ejecutar las tareas asociadas a la entidad de seguridad.
Id
Lectura/escritura
Obtiene o establece el identificador de la entidad de seguridad.
LogonType
Lectura/escritura
Obtiene o establece el método de inicio de sesión de seguridad necesario para ejecutar las tareas asociadas a la entidad de seguridad.
Ejecución
Lectura/escritura
Obtiene o establece el identificador que se usa para especificar el nivel de privilegio necesario para ejecutar las tareas asociadas a la entidad de seguridad.
Userid
Lectura/escritura
Obtiene o establece el identificador de usuario necesario para ejecutar las tareas asociadas a la entidad de seguridad.

Observaciones

Al especificar una cuenta, recuerde usar correctamente la barra diagonal inversa doble en el código para especificar el dominio y el nombre de usuario. Por ejemplo, use DOMAIN\\UserName para especificar un valor para la propiedad UserId .

Al leer o escribir XML para una tarea, las credenciales de seguridad de una entidad de seguridad se especifican en el elemento Principal del esquema del Programador de tareas.

Si una tarea se registra mediante la herramienta de línea de comandos at.exe y este objeto se usa para recuperar información sobre la tarea, la propiedad LogonType devolverá 0, la propiedad RunLevel devolverá 0 y la propiedad UserId devolverá Nothing.

Ejemplos

Para obtener más información y código de ejemplo 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