Set-JobTrigger

Sintaxe

Set-JobTrigger
   [-InputObject] <ScheduledJobTrigger[]>
   [-DaysInterval <Int32>]
   [-WeeksInterval <Int32>]
   [-RandomDelay <TimeSpan>]
   [-At <DateTime>]
   [-User <String>]
   [-DaysOfWeek <DayOfWeek[]>]
   [-AtStartup]
   [-AtLogOn]
   [-Once]
   [-RepetitionInterval <TimeSpan>]
   [-RepetitionDuration <TimeSpan>]
   [-RepeatIndefinitely]
   [-Daily]
   [-Weekly]
   [-PassThru]
   [<CommonParameters>]

Description

O cmdlet Set-JobTrigger altera as propriedades dos gatilhos de trabalho de trabalhos agendados. Você pode usá-lo para alterar a hora ou a frequência em que os trabalhos iniciam ou mudam de agendamentos baseados em tempo para agendamentos que são disparados por um logon ou inicialização.

Um gatilho de trabalho define uma agenda ou condições recorrentes para iniciar um trabalho agendado. Embora os gatilhos de trabalho não sejam salvos em disco, você pode alterar os gatilhos de trabalho de trabalhos agendados, que são salvos em disco.

Para alterar um gatilho de trabalho de um trabalho agendado, comece usando o cmdlet Get-JobTrigger para obter o gatilho de trabalho de um trabalho agendado. Em seguida, redirecione o gatilho para Set-JobTrigger ou salve o gatilho em uma variável e use o parâmetro InputObject do cmdlet Set-JobTrigger para identificar o gatilho. Use os parâmetros restantes de Set-JobTrigger para alterar o gatilho de trabalho.

Quando você altera o tipo de gatilho de trabalho, como alterar um gatilho de trabalho de um gatilho diário ou semanal para um gatilho AtLogon, as propriedades originais do gatilho são excluídas. No entanto, se você alterar os valores do gatilho, mas não seu tipo, como alterar os dias em um gatilho semanal, somente as propriedades especificadas serão alteradas. Todas as outras propriedades do gatilho de trabalho original são retidas.

Set-JobTrigger é um de uma coleção de cmdlets de agendamento de trabalho no módulo PSScheduledJob incluído no Windows PowerShell.

Para obter mais informações sobre trabalhos agendados, consulte os tópicos sobre no módulo PSScheduledJob. Importe o módulo PSScheduledJob e digite: Get-Help about_Scheduled* ou veja about_Scheduled_Jobs.

Esse cmdlet foi introduzido no Windows PowerShell 3.0.

Exemplos

Exemplo 1: alterar os dias em um gatilho de trabalho

PS C:\> Get-JobTrigger -Name "DeployPackage"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Weekly          9/29/2011 12:00:00 AM  {Wednesday, Saturday}   True

The second command uses the Get-JobTrigger cmdlet to get the job trigger of the DeployPackage scheduled job. A pipeline operator (|) sends the trigger to the **Set-JobTrigger** cmdlet, which changes the job trigger so that it starts the DeployPackage job on Wednesdays and Sundays. The command uses the *Passthru* parameter to return the trigger after the change.
PS C:\> Get-JobTrigger -Name "DeployPackage" | Set-JobTrigger -DaysOfWeek "Wednesday", "Sunday" -Passthru
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Weekly          9/29/2011 12:00:00 AM  {Wednesday, Sunday}     True

Este exemplo mostra como alterar os dias em um gatilho de trabalho semanal.

O primeiro comando usa o cmdlet Get-JobTrigger para obter o gatilho de trabalho do trabalho agendado DeployPackage. A saída mostra que o gatilho inicia o trabalho à meia-noite às quartas-feiras e sábados.

Esse comando não é necessário; ele é incluído apenas para mostrar o efeito da alteração do gatilho.

Exemplo 2: alterar o tipo de gatilho de trabalho

PS C:\> Get-JobTrigger -Name "Inventory"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           9/27/2011 11:00:00 PM                          True
2          AtStartup                                                      True

The second command uses the **Get-JobTrigger** cmdlet to get the *AtStartup* job trigger of the Inventory job. The command uses the *TriggerID* parameter to identify the job trigger. A pipeline operator (|) sends the job trigger to the **Set-JobTrigger** cmdlet, which changes it to a weekly job trigger that runs every four weeks on Monday at midnight. The command uses the *Passthru* parameter to return the trigger after the change.
PS C:\> Get-JobTrigger -Name "Inventory" -TriggerID 2 | Set-JobTrigger -Weekly -WeeksInterval 4 -DaysOfWeek Monday -At "12:00 AM"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           9/27/2011 11:00:00 PM                          True
2          Weekly          10/31/2011 12:00:00 AM {Monday}                True

Este exemplo mostra como alterar o tipo de gatilho de trabalho que inicia um trabalho. Os comandos neste exemplo substituem um gatilho de trabalho AtStartup por um gatilho semanal.

O primeiro comando usa o cmdlet Get-JobTrigger para obter o gatilho de trabalho do trabalho agendado de Inventário. A saída mostra que o trabalho tem dois gatilhos diários e um gatilho AtStartup.

Esse comando não é necessário; ele é incluído apenas para mostrar o efeito da alteração do gatilho.

Exemplo 3: alterar o usuário em um gatilho de trabalho remoto

PS C:\> Invoke-Command -ComputerName "Server01" -ScriptBlock {Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.User} | Set-JobTrigger -User "Domain01/Admin02"}

Esse comando altera o usuário em todos os AtLogon gatilhos de trabalho de trabalhos agendados no computador Server01.

O comando usa o cmdlet Invoke-Command para executar um comando no computador Server01.

O comando remoto começa com um comando Get-ScheduledJob que obtém todos os trabalhos agendados no computador. Os trabalhos agendados são canalizados para o cmdlet Get-JobTrigger, que obtém os gatilhos de trabalho dos trabalhos agendados. Cada gatilho de trabalho contém uma propriedade JobDefinition que contém o trabalho agendado, portanto, o gatilho permanece associado ao trabalho agendado mesmo quando ele é alterado.

Os gatilhos de trabalho são canalizados para o cmdlet Where-Object, que obtém gatilhos de trabalho que têm a propriedade User. Os gatilhos de trabalho selecionados são canalizados para o cmdlet Set-JobTrigger, que altera o usuário para Domain01\Admin02.

Exemplo 4: alterar um dos muitos gatilhos de trabalho

PS C:\> Get-JobTrigger -Name "SecurityCheck"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           4/24/2013 3:00:00 AM                           True
2          Weekly          4/24/2013 4:00:00 PM   {Sunday}                True
3          Once            4/24/2013 4:00:00 PM                           True

The second command uses the **TriggerID** parameter of the **Get-JobTrigger** cmdlet to get the *Once* trigger of the SecurityCheck scheduled job. The command pipes the trigger to the Format-List cmdlet, which displays all of the properties of the *Once* job trigger.The output shows that the trigger starts the job once every hour (RepetitionInterval = 1 hour) for one day (RepetitionDuration = 1 day).
PS C:\> Get-JobTrigger -Name "SecurityCheck" -TriggerID 3 | Format-List -Property *
At                 : 4/24/2012 4:00:00 PM
DaysOfWeek         :
Interval           : 1
Frequency          : Once
RandomDelay        : 00:00:00
RepetitionInterval : 01:00:00
RepetitionDuration : 1.00:00:00
User               :
Id                 : 3
Enabled            : True
JobDefinition      : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

The third command changes the repetition interval of the job trigger from one hour to 90 minutes. The command does not return any output.
PS C:\> Get-JobTrigger -Name "SecurityCheck" -TriggerId 3 | Set-JobTrigger -RepetitionInterval (New-TimeSpan -Minutes 90)

The fourth command displays the effect of the change.The output shows that the trigger starts the job once every 90 minutes (RepetitionInterval = 1 hour, 30 minutes) for one day (RepetitionDuration = 1 day).
PS C:\> Get-JobTrigger -Name "SecurityCheck" -TriggerID 3 | Format-List -Property *
At                 : 4/24/2012 4:00:00 PM
DaysOfWeek         :
Interval           : 1
Frequency          : Once
RandomDelay        : 00:00:00
RepetitionInterval : 01:30:00
RepetitionDuration : 1.00:00:00
User               :
Id                 : 3
Enabled            : True
JobDefinition      : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Os comandos neste exemplo alteram o intervalo de repetição do Uma vez gatilho de trabalho do trabalho agendado securitycheck de cada 60 minutos para cada 90 minutos. O trabalho agendado SecurityCheck tem três gatilhos de trabalho, portanto, os comandos usam o parâmetro TriggerId do cmdlet Get-JobTrigger para identificar o gatilho de trabalho que está sendo alterado.

O primeiro comando usa o cmdlet Get-JobTrigger para obter todos os gatilhos de trabalho do trabalho agendado securitycheck. A saída, que exibe as IDs dos gatilhos de trabalho, revela que o gatilho de trabalho Once tem uma ID de 3.

Parâmetros

-At

-AtLogOn

-AtStartup

-Daily

-DaysInterval

-DaysOfWeek

-InputObject

-Once

-PassThru

-RandomDelay

-RepeatIndefinitely

-RepetitionDuration

-RepetitionInterval

-User

-Weekly

-WeeksInterval

Entradas

ScheduledJobTrigger

Você pode redirecionar vários gatilhos de trabalho para Set-JobTrigger.

Saídas

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Quando você usa o parâmetro Passthru, Set-JobTrigger retorna os gatilhos de trabalho que foram alterados. Caso contrário, esse cmdlet não gerará nenhuma saída.

Observações

• Os gatilhos de trabalho têm uma propriedade JobDefintion que os associa ao trabalho agendado. Quando você altera o gatilho de trabalho de um trabalho agendado, o trabalho é alterado. Você não precisa usar um comando Set-ScheduledJob para aplicar o gatilho alterado ao trabalho agendado.

Links Relacionados

• about_Scheduled_Jobs
• Add-JobTrigger
• Disable-JobTrigger
• Disable-ScheduledJob
• Enable-JobTrigger
• Enable-ScheduledJob
• Get-JobTrigger
• Get-ScheduledJob
• Get-ScheduledJobOption
• New-JobTrigger
• New-ScheduledJobOption
• Register-ScheduledJob
• Remove-JobTrigger
• Set-JobTrigger
• Set-ScheduledJob
• Set-ScheduledJobOption
• Unregister-ScheduledJob