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 |
|
| Archivo DLL |
|