Compartilhar via


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