Partilhar via


Objeto TaskSettings

Um objeto de script que fornece as configurações que o serviço agendador de tarefas usa para executar a tarefa.

Membros

O objeto TaskSettings tem estes tipos de membros:

Propriedades

O objeto TaskSettings tem essas propriedades.

Propriedade Tipo de acesso Descrição
AllowDemandStart
Leitura/gravação
Obtém ou define um valor booliano que indica que a tarefa pode ser iniciada usando o comando Executar ou o menu Contexto.
AllowHardTerminate
Leitura/gravação
Obtém ou define um valor booliano que indica que a tarefa pode ser encerrada usando TerminateProcess.
Compatibilidade
Leitura/gravação
Obtém ou define um valor inteiro que indica com qual versão do Agendador de Tarefas uma tarefa é compatível.
DeleteExpiredTaskAfter
Leitura/gravação
Obtém ou define a quantidade de tempo que o Agendador de Tarefas aguardará antes de excluir a tarefa após a expiração.
DisallowStartIfOnBatteries
Leitura/gravação
Obtém ou define um valor booliano que indica que a tarefa não será iniciada se o computador estiver em execução com a energia da bateria.
habilitado
Leitura/gravação
Obtém ou define um valor booliano que indica que a tarefa está habilitada. A tarefa só pode ser executada quando essa configuração é True.
ExecutionTimeLimit
Leitura/gravação
Obtém ou define o tempo permitido para concluir a tarefa.
Hidden
Leitura/gravação
Obtém ou define um valor booliano que indica que a tarefa não ficará visível na interface do usuário. No entanto, os administradores podem substituir essa configuração por meio do uso de uma "opção master" que torna todas as tarefas visíveis na interface do usuário.
IdleSettings
Leitura/gravação
Obtém ou define as informações que especificam como o Agendador de Tarefas executa tarefas quando o computador está em um estado ocioso.
MultipleInstances
Leitura/gravação
Obtém ou define a política que define como o Agendador de Tarefas lida com várias instâncias da tarefa.
NetworkSettings
Leitura/gravação
Obtém ou define o objeto de configurações de rede que contém um nome e um identificador de perfil de rede. Se a propriedade RunOnlyIfNetworkAvailable de TaskSettings for True e um propfile de rede for especificado na propriedade NetworkSettings , a tarefa será executada somente se o perfil de rede especificado estiver disponível.
Priority
Leitura/gravação
Obtém ou define o nível de prioridade da tarefa.
RestartCount
Leitura/gravação
Obtém ou define o número de vezes que o Agendador de Tarefas tentará reiniciar a tarefa.
RestartInterval
Leitura/gravação
Obtém ou define um valor que especifica por quanto tempo o Agendador de Tarefas tentará reiniciar a tarefa.
RunOnlyIfIdle
Leitura/gravação
Obtém ou define um valor booliano que indica que o Agendador de Tarefas executará a tarefa somente se o computador estiver em um estado ocioso.
RunOnlyIfNetworkAvailable
Leitura/gravação
Obtém ou define um valor booliano que indica que o Agendador de Tarefas executará a tarefa somente quando uma rede estiver disponível.
StartWhenAvailable
Leitura/gravação
Obtém ou define um valor booliano que indica que o Agendador de Tarefas pode iniciar a tarefa a qualquer momento depois que o horário agendado tiver passado.
StopIfGoingOnBatteries
Leitura/gravação
Obtém ou define um valor booliano que indica que a tarefa será interrompida se o computador começar a ser executado com a energia da bateria.
WakeToRun
Leitura/gravação
Obtém ou define um valor booliano que indica que o Agendador de Tarefas ativará o computador quando for a hora de executar a tarefa.
Xmltext
Leitura/gravação
Obtém ou define uma definição formatada em XML das configurações da tarefa.

Comentários

Por padrão, uma tarefa será interrompida 72 horas depois de começar a ser executada. Você pode alterar isso alterando a configuração ExecutionTimeLimit .

Ao ler ou gravar XML para uma tarefa, as configurações de tarefa são definidas no elemento Configurações do esquema agendador de tarefas.

Exemplos

Para obter mais informações e um exemplo de código 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

Confira também

Agendador de Tarefas

TaskDefinition

NetworkSettings

IdleSettings