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 |
|
| DLL |
|