Elemento Settings (taskType)
Especifica as configurações que o Agendador de Tarefas usa para executar a tarefa.
<xs:element name="Settings"
type="settingsType"
minOccurs="0"
/>
O elemento Settings é definido pelo tipo complexo taskType .
Elemento pai
| Elemento | Derivado de | Descrição |
|---|---|---|
| Tarefa | Tasktype | Especifica a tarefa executada pelo serviço Agendador de Tarefas. |
Elementos filho
| Elemento | Type | Descrição |
|---|---|---|
| AllowHardTerminate | booleano | Especifica que a tarefa pode ser encerrada usando TerminateProcess. |
| AllowStartOnDemand | booleano | Especifica que a tarefa pode ser iniciada usando o comando Executar ou o menu Contexto. |
| DeleteExpiredTaskAfter | duration | Especifica a quantidade de tempo que o Agendador de Tarefas aguardará antes de excluir a tarefa depois que ela expirar. |
| DisallowStartIfOnBatteries | booleano | Especifica que a tarefa não será iniciada se o computador estiver em execução com baterias. |
| Habilitado | booleano | Especifica que a tarefa está habilitada. A tarefa só pode ser executada quando essa configuração é True. |
| ExecutionTimeLimit | duration | Tempo permitido para concluir a tarefa. |
| Hidden | booleano | Especifica que a tarefa não ficará visível na interface do usuário por padrão. |
| IdleSettings | idleSettingsType | Especifica como o Agendador de Tarefas executa tarefas quando o computador está em um estado ocioso. |
| MaintenanceSettings | maintenanceSettingsType | Especifica como o Agendador de Tarefas executa tarefas durante a manutenção automática. |
| MultipleInstancesPolicy | multipleInstancesPolicyType | Especifica a política que define como o Agendador de Tarefas lida com várias instâncias da tarefa. |
| Priority | priorityType | Especifica o nível de prioridade para a tarefa. |
| RestartOnFailure | restartType | Especifica que o Agendador de Tarefas tentará reiniciar a tarefa se a tarefa falhar por algum motivo. |
| RunOnlyIfIdle | booleano | Especifica que a tarefa é executada somente quando o computador está em um estado ocioso. |
| RunOnlyIfNetworkAvailable | booleano | Especifica que o Agendador de Tarefas executará a tarefa somente quando uma rede estiver disponível. |
| StartWhenAvailable | booleano | Especifica que o Agendador de Tarefas pode iniciar a tarefa a qualquer momento depois que o horário agendado tiver passado. |
| StopIfGoingOnBatteries (settingsType) | booleano | Especifica que a tarefa será interrompida se o computador estiver entrando em baterias. |
| Volátil | booleano | Especifica se a tarefa é desabilitada automaticamente pelo Agendador de Tarefas na inicialização do Windows. |
| WakeToRun (settingsType) | booleano | Especifica que o Agendador de Tarefas ativará o computador quando for hora de executar a tarefa. |
Comentários
Você pode selecionar um ou mais dos elementos filho referenciados acima.
Para o desenvolvimento do C++, as informações de registro de uma tarefa são especificadas usando a propriedade Settings de ITaskDefinition.
Para o desenvolvimento de scripts, as informações de registro de uma tarefa são especificadas usando a propriedade TaskDefinition.Settings .
Exemplos
O exemplo de código XML a seguir define um elemento de configurações que permite um encerramento rígido da tarefa.
<task>
<Settings>
<AllowHardTerminate>true</AllowHardTerminate>
<AllowStartOnDemand>true</AllowStartOnDemand>
</Settings>
</task>
Para obter mais informações e um exemplo completo do XML para definir as configurações da tarefa, consulte Exemplo de gatilho de tempo (XML).
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] |