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]

Confira também

Elementos de esquema do agendador de tarefas

Agendador de Tarefas