Set-ScheduledJobOption

Não interrompa a tarefa se o computador alternar para a energia da bateria (desconectado da corrente alternada) enquanto o trabalho estiver em execução. Por padrão, os trabalhos agendados param quando o computador é desconectado da corrente alternada.

O parâmetro ContinueIfGoingOnBattery define o valor da propriedade StopIfGoingOnBatteries de trabalhos agendados como $True.

Inicie o trabalho somente quando ele é acionado. Os usuários não podem iniciar o trabalho manualmente, como usando a execução de recursos no Agendador de tarefas.

Este parâmetro afeta somente o Agendador de tarefas. Ele não impede que os usuários usem o cmdlet Start-Job para iniciar o trabalho.

O parâmetro DoNotAllowDemandStart define o valor da propriedade DoNotAllowDemandStart de trabalhos agendados como $True.

Não exiba o trabalho no Agendador de tarefas. Esse valor afeta somente o computador no qual o trabalho é executado. Por padrão, as tarefas agendadas são exibidas no Agendador de tarefas.

Mesmo que uma tarefa esteja oculta, os usuários poderão exibir a tarefa selecionando a opção Mostrar exibição de tarefas ocultas no Agendador de Tarefas.

O parâmetro HideInTaskScheduler define o valor da propriedade ShowInTaskScheduler de trabalhos agendados como $False.

Especifica quanto tempo o computador deve permanecer ocioso antes de iniciar o trabalho. O valor padrão é 10 minutos. Se o computador não estiver ocioso durante o tempo especificado antes do valor de IdleTimeout expirar, o trabalho agendado não será executado até que a próxima execução agendada, se houver.

Insira um objeto timespan, como um gerado pelo cmdlet New-TimeSpan ou insira um valor no <formato hours>:<minutes>:<seconds> que é convertido automaticamente em um objeto TimeSpan .

Para habilitar esse valor, use o parâmetro StartIfIdle. Por padrão, a propriedade StartIfNotIdle de trabalhos agendados é definida como $True e Windows PowerShell ignora os valores IdleDuration e IdleTimeout.

Especifica quanto tempo o computador deve permanecer ocioso antes de iniciar o trabalho. O valor padrão é 10 minutos. Se o computador não estiver ocioso durante o tempo especificado antes do valor de IdleTimeout expirar, o trabalho agendado não será executado até que a próxima execução agendada, se houver.

Insira um objeto timespan, como um gerado pelo cmdlet New-TimeSpan ou insira um valor no <formato hours>:<minutes>:<seconds> que é convertido automaticamente em um objeto TimeSpan .

Para habilitar esse valor, use o parâmetro StartIfIdle. Por padrão, a propriedade StartIfNotIdle de trabalhos agendados é definida como $True e Windows PowerShell ignora os valores IdleDuration e IdleTimeout.

Especifica as opções de trabalho. Insira uma variável que contenha objetos ScheduledJobOptions ou digite um comando ou expressão que obtém objetos ScheduledJobOptions , como um comando Get-ScheduledJobOption. Você também pode canalizar um objeto ScheduledJobOptions para Set-ScheduledJobOption.

Determina como o sistema responde a uma solicitação para iniciar uma instância de um trabalho agendado, enquanto outra instância de trabalho está em execução. Os valores aceitáveis para esse parâmetro são:

• IgnoreNew. A nova instância de trabalho será ignorada. Esse é o valor padrão.
• Paralelo. A nova instância de trabalho será iniciada imediatamente.
• Fila. A nova instância de trabalho começa assim que a instância atual for concluída.
• StopExisting. A instância atual do trabalho parado e a nova instância foram iniciadas.

Para executar o trabalho, todas as condições da agenda de trabalho devem ser atendidas. Por exemplo, se as condições definidas pelos parâmetros RequireNetwork, IdleDuration e IdleTimeout não forem atendidas, a instância do trabalho não será iniciada, independentemente do valor desse parâmetro.

Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera saída.

Executa a tarefa agendada somente quando conexões de rede estão disponíveis.

Se você especificar esse parâmetro e a rede não estiver disponível na hora de início agendada, o trabalho não será executado até a próxima hora de início agendada, se houver alguma.

O parâmetro RequireNetwork define o valor da propriedade RunWithoutNetwork de trabalhos agendados como $False.

Reinicia um trabalho agendado quando o computador ficar ocioso. Esse parâmetro funciona com o parâmetroStopIfGoingOffIdle, que suspende um trabalho agendado em execução se o computador se torna ativo (deixe o estado ocioso).

O parâmetro RestartOnIdleResume define o valor da propriedade RestartOnIdleResume de trabalhos agendados como $True.

Executa o trabalho agendado com as permissões de um membro do grupo Administradores no computador no qual o trabalho é executado.

Para habilitar um trabalho agendado a ser executado com permissões de Administrador, use o parâmetro Credential de Register-ScheduledJob para fornecer credenciais explícitas para o trabalho.

O parâmetro RunElevated define o valor da propriedade RunElevated de trabalhos agendados como True.

Inicia o trabalho agendado, se o computador estiver ocioso durante o tempo especificado pelo parâmetro IdleDuration antes da hora especificada pelo parâmetro IdleTimeout expirar.

Por padrão, os parâmetros IdleDuration e IdleTimeout serão ignorados e o trabalho será iniciado na hora de início agendada, mesmo se o computador estiver ocupado.

Se você especificar esse parâmetro e o computador estiver ocupado (não ocioso) na hora de início agendada, o trabalho não será executado até a próxima hora de início agendada se houver.

O parâmetro StartIfIdle define o valor da propriedade StartIfNotIdle de trabalhos agendados como False.

Inicia o trabalho agendado, mesmo se o computador estiver usando baterias na hora de início agendada. O valor padrão é False.

O parâmetro StartIfOnBattery define o valor da propriedade StartIfOnBatteries de trabalhos agendados como $True.

Suspende um trabalho agendado em execução se o computador se torna ativo (não ocioso) enquanto o trabalho está em execução.

Por padrão, um trabalho agendado é suspenso quando o computador se torna ativo e retomado quando o computador tornar-se ocioso novamente. Para alterar esse comportamento padrão, utilize o parâmetro RestartOnIdleResume.

O parâmetro StopIfGoingOffIdle define o valor da propriedade StopIfGoingOffIdle de trabalhos agendados como $True.

Desperta o computador de um estado de suspensão ou de hibernação na hora de início agendada para que possa executar o trabalho. Por padrão, se o computador está em um estado de suspensão ou de hibernação na hora de início agendada, o trabalho não será executado.

O parâmetro WakeToRun define o valor da propriedade WakeToRun de trabalhos agendados como $True.