Elemento Principals (taskType)

Especifica os contextos de segurança que podem ser usados para executar a tarefa.

<xs:element name="Principals"
    type="principalsType"
 />

O elemento Principals é definido pelo tipo complexo taskType .

Elemento pai

Elemento	Derivado de	Descrição
Tarefa	Tasktype	Define a tarefa executada pelo serviço Agendador de Tarefas.

Elementos filho

Elemento	Type	Descrição
Entidade de segurança	Principaltype	Especifica as credenciais de segurança de uma entidade de segurança.

Comentários

Você pode especificar até 32 entidades de segurança para uma tarefa.

Para desenvolvimento de scripts, as entidades de segurança de uma tarefa são especificadas usando a propriedade TaskDefinition.Principal .

Para o desenvolvimento do C++, as entidades de segurança de uma tarefa são especificadas usando a propriedade Principal de ITaskDefinition.

Exemplos

O XML a seguir define duas entidades de segurança: um identificador de usuário e uma entidade de segurança de identificador de grupo para a tarefa.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]

Confira também

Elementos de esquema do agendador de tarefas

Agendador de Tarefas