Elemento Principal (principalType)

Especifica las credenciales de seguridad de una entidad de seguridad. Estas credenciales definen el contexto de seguridad en el que se ejecuta una tarea.

<xs:element name="Principal"
    type="principalType"
 />

El elemento Principal se define mediante el tipo complejo principalType .

Elemento primario

Elemento	Derivado de	Descripción
Entidades de seguridad	principalsType	Especifica las entidades de seguridad asociadas a la tarea.

Elementos secundarios

Elemento	Tipo	Descripción
DisplayName	string	Especifica el nombre de la entidad de seguridad que se muestra en la interfaz de usuario del Programador de tareas.
Groupid	string	Especifica el identificador del grupo de usuarios necesario para ejecutar tareas asociadas a la entidad de seguridad.
LogonType	logonType	Especifica el método de inicio de sesión de seguridad necesario para ejecutar esas tareas asociadas a la entidad de seguridad.
Userid	string	Especifica el identificador de usuario necesario para ejecutar tareas asociadas a la entidad de seguridad.

Atributos

Nombre	Tipo	Descripción
Identificador	ID	Identificador de la definición de entidad de seguridad.

Comentarios

Para el desarrollo de scripting, las credenciales de seguridad de una entidad de seguridad se especifican mediante el objeto Principal .

Para el desarrollo de C++, las credenciales de seguridad de una entidad de seguridad se especifican mediante la interfaz IPrincipal .

Los elementos secundarios enumerados anteriormente se definen mediante el tipo complejo principalType . Para obtener información sobre la secuenciación de estos elementos secundarios, vea principalType.

Ejemplos

El siguiente XML define una entidad de seguridad con un identificador de usuario.

<Principals>
    <Principal>
        <UserId></UserId>
        <LogonType><LogonType>
        <DisplayName></DisplayName>
    </Principal>
</Principals>

El siguiente XML define una entidad de seguridad con un identificador de grupo.

<Principals>
    <Principal>
        <GroupId></GroupId>
        <DisplayName></DisplayName>
    </Principal>
</Principals>

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]

Consulte también

Programador de tareas