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 |
|
| DLL |
|
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de