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. Isso não impede que os usuários usem o Start-Job cmdlet 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 podem exibi-la selecionando a opção de exibição Mostrar 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 pela duração especificada antes que o valor de IdleTimeout expire, o trabalho agendado não será executado até o próximo horário agendado, se houver.

Insira um objeto timespan, como um gerado pelo New-TimeSpan cmdlet, ou insira um valor no <hours>:<minutes>:<seconds> formato 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 o 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 pela duração especificada antes que o valor de IdleTimeout expire, o trabalho agendado não será executado até o próximo horário agendado, se houver.

Insira um objeto timespan, como um gerado pelo New-TimeSpan cmdlet, ou insira um valor no <hours>:<minutes>:<seconds> formato 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 o 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 obtenha objetos ScheduledJobOptions , como um Get-ScheduledJobOption comando. 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 é ignorada. Este é o valor padrão.
• Parallel - A nova instância de trabalho é iniciada imediatamente.
• Queue - A nova instância de trabalho é iniciada assim que a instância atual é concluída.
• StopExisting - A instância atual do trabalho é interrompida e a nova instância é iniciada.

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âmetro StopIfGoingOffIdle, que suspende um trabalho agendado em execução se o computador se tornar ativo (deixar 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 permitir que um trabalho agendado seja executado com permissões de administrador, use o parâmetro Credential de Register-ScheduledJob para fornecer uma credencial explícita 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 tiver ficado ocioso pelo tempo especificado pelo parâmetro IdleDuration antes que o tempo especificado pelo parâmetro IdleTimeout expire.

Por padrão, os parâmetros IdleDuration e IdleTimeout são ignorados e o trabalho é iniciado na hora de início agendada, mesmo que o computador esteja 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, use 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.