Partilhar via


Objeto Principal

Objeto de script que fornece as credenciais de segurança para uma entidade de segurança. Essas credenciais de segurança definem o contexto de segurança para as tarefas associadas à entidade de segurança.

Membros

O objeto Principal tem esses tipos de membros:

Propriedades

O objeto Principal tem essas propriedades.

Propriedade Tipo de acesso Descrição
DisplayName
Leitura/gravação
Obtém ou define o nome da entidade de segurança exibida na interface do usuário do Agendador de Tarefas.
Groupid
Leitura/gravação
Obtém ou define o identificador do grupo de usuários necessário para executar as tarefas associadas à entidade de segurança.
Id
Leitura/gravação
Obtém ou define o identificador da entidade de segurança.
LogonType
Leitura/gravação
Obtém ou define o método de logon de segurança necessário para executar as tarefas associadas à entidade de segurança.
Runlevel
Leitura/gravação
Obtém ou define o identificador usado para especificar o nível de privilégio necessário para executar as tarefas associadas à entidade de segurança.
Userid
Leitura/gravação
Obtém ou define o identificador de usuário necessário para executar as tarefas associadas à entidade de segurança.

Comentários

Ao especificar uma conta, lembre-se de usar corretamente a barra invertida dupla no código para especificar o domínio e o nome de usuário. Por exemplo, use DOMAIN\\UserName para especificar um valor para a propriedade UserId .

Ao ler ou gravar XML para uma tarefa, as credenciais de segurança de uma entidade de segurança são especificadas no elemento Principal do esquema do Agendador de Tarefas.

Se uma tarefa for registrada usando a ferramenta de linha de comando at.exe e esse objeto for usado para recuperar informações sobre a tarefa, a propriedade LogonType retornará 0, a propriedade RunLevel retornará 0 e a propriedade UserId retornará Nothing.

Exemplos

Para obter mais informações e código de exemplo para esse objeto de script, consulte Exemplo de gatilho de tempo (script).

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]
Biblioteca de tipos
Taskschd.tlb
DLL
Taskschd.dll