Set-JobTrigger

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

Set-JobTrigger cmdlet은 예약된 작업의 작업 트리거 속성을 변경합니다. 이를 사용하여 작업이 시작되는 시간 또는 빈도를 변경하거나 시간 기반 일정에서 로그온 또는 시작에 의해 트리거되는 일정으로 변경할 수 있습니다.

작업 트리거는 예약된 작업을 시작하기 위한 되풀이 일정 또는 조건을 정의합니다. 작업 트리거는 디스크에 저장되지 않지만 디스크에 저장된 예약된 작업의 작업 트리거를 변경할 수 있습니다.

예약된 작업의 작업 트리거를 변경하려면 먼저 Get-JobTrigger cmdlet을 사용하여 예약된 작업의 작업 트리거를 가져옵니다. 그런 다음, 트리거를 Set-JobTrigger 파이프하거나 변수에 트리거를 저장하고 Set-JobTrigger cmdlet의 InputObject 매개 변수를 사용하여 트리거를 식별합니다. set-JobTrigger 나머지 매개 변수를 사용하여 작업 트리거를 변경합니다.

매일 또는 매주 트리거에서 AtLogon 트리거로 작업 트리거를 변경하는 등 작업 트리거의 유형을 변경하면 원래 트리거 속성이 삭제됩니다. 그러나 트리거의 값을 변경하지만 해당 형식은 변경하지 않는 경우(예: 주간 트리거의 일 변경) 지정한 속성만 변경됩니다. 원래 작업 트리거의 다른 모든 속성은 유지됩니다.

Set-JobTrigger Windows PowerShell에 포함된 PSScheduledJob 모듈의 작업 예약 cmdlet 컬렉션 중 하나입니다.

예약된 작업에 대한 자세한 내용은 PSScheduledJob 모듈의 정보 항목을 참조하세요. PSScheduledJob 모듈을 가져온 다음 Get-Help about_Scheduled* 입력하거나 about_Scheduled_Jobs 확인합니다.

이 cmdlet은 Windows PowerShell 3.0에서 도입되었습니다.

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

이 예제에서는 주간 작업 트리거의 일을 변경하는 방법을 보여줍니다.

첫 번째 명령은 Get-JobTrigger cmdlet을 사용하여 DeployPackage 예약 작업의 작업 트리거를 가져옵니다. 출력은 트리거가 수요일과 토요일 자정에 작업을 시작한다는 것을 보여줍니다.

이 명령은 필수가 아닙니다. 단지 트리거 변경의 결과를 보여 주기 위해 포함되었습니다.

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

이 예제에서는 작업을 시작하는 작업 트리거의 유형을 변경하는 방법을 보여 줍니다. 이 예제의 명령은 AtStartup 작업 트리거를 주간 트리거로 바꿉니다.

첫 번째 명령은 Get-JobTrigger cmdlet을 사용하여 인벤토리 예약 작업의 작업 트리거를 가져옵니다. 출력은 작업에 매일 트리거와 AtStartup 트리거가 있는 두 개의 트리거가 있음을 보여 줍니다.

이 명령은 필수가 아닙니다. 단지 트리거 변경의 결과를 보여 주기 위해 포함되었습니다.

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

이 명령은 Server01 컴퓨터에서 예약된 작업의 모든 AtLogon 작업 트리거에서 사용자를 변경합니다.

이 명령은 Invoke-Command cmdlet을 사용하여 Server01 컴퓨터에서 명령을 실행합니다.

원격 명령은 컴퓨터에서 예약된 모든 작업을 가져오는 Get-ScheduledJob 명령으로 시작합니다. 예약된 작업은 예약된 작업의 작업 트리거를 가져오는 Get-JobTrigger cmdlet으로 파이프됩니다. 각 작업 트리거에는 예약된 작업이 포함된 JobDefinition 속성이 포함되어 있으므로 트리거는 변경되더라도 예약된 작업과 연결된 상태로 유지됩니다.

작업 트리거는 Where-Object cmdlet으로 파이프되며, 이 cmdlet은 User 속성이 있는 작업 트리거를 가져옵니다. 선택한 작업 트리거는 Set-JobTrigger cmdlet으로 파이프되어 사용자를 Domain01\Admin02로 변경합니다.

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

이 예제의 명령은 SecurityCheck 예약 작업의 한 번 작업 트리거의 반복 간격을 60분마다 90분마다 변경합니다. SecurityCheck 예약된 작업에는 세 개의 작업 트리거가 있으므로 명령은 Get-JobTrigger cmdlet의 TriggerId 매개 변수를 사용하여 변경되는 작업 트리거를 식별합니다.

첫 번째 명령은 Get-JobTrigger cmdlet을 사용하여 SecurityCheck 예약 작업의 모든 작업 트리거를 가져옵니다. 작업 트리거의 ID를 표시하는 출력은 Once 작업 트리거의 ID가 3임을 나타냅니다.

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

여러 작업 트리거를 Set-JobTrigger로 파이프할 수 있습니다.

Passthru 매개 변수를 사용하는 경우 Set-JobTrigger 변경된 작업 트리거를 반환합니다. 그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.

• 작업 트리거에는 예약된 작업과 연결하는 JobDefintion 속성이 있습니다. 예약된 작업의 작업 트리거를 변경하면 작업이 변경됩니다. Set-ScheduledJob 명령을 사용하여 변경된 트리거를 예약된 작업에 적용할 필요가 없습니다.