Elemento Principal (principalType)

  • Artigo

Especifica as credenciais de segurança de uma entidade de segurança. Essas credenciais definem o contexto de segurança em que uma tarefa é executada.

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

O elemento Principal é definido pelo tipo complexo principalType .

Elemento pai

Elemento Derivado de Descrição
Entidades principalsType Especifica as entidades de segurança associadas à tarefa.

Elementos filho

Elemento Type Descrição
DisplayName cadeia de caracteres Especifica o nome da entidade de segurança exibida na interface do usuário do Agendador de Tarefas.
Groupid cadeia de caracteres Especifica o identificador do grupo de usuários necessário para executar tarefas associadas à entidade de segurança.
LogonType logonType Especifica o método de logon de segurança necessário para executar essas tarefas associadas à entidade de segurança.
Userid cadeia de caracteres Especifica o identificador de usuário necessário para executar tarefas associadas à entidade de segurança.

Atributos

Nome Tipo Descrição
ID ID Identificador da definição da entidade de segurança.

Comentários

Para o desenvolvimento de scripts, as credenciais de segurança de uma entidade de segurança são especificadas usando o objeto Principal .

Para o desenvolvimento do C++, as credenciais de segurança de uma entidade de segurança são especificadas usando a interface IPrincipal .

Os elementos filho listados acima são definidos pelo tipo complexo principalType . Para obter informações de sequenciamento para esses elementos filho, consulte principalType.

Exemplos

O XML a seguir define uma entidade de segurança com um identificador de usuário.

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

O XML a seguir define uma entidade de segurança com um identificador de grupo.

<Principals>
    <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

Agendador de Tarefas