다음을 통해 공유

Add-JobTrigger

  • 참조
모듈:
PSScheduledJob

예약된 작업에 작업 트리거를 추가합니다.

구문

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]

Description

Add-JobTrigger cmdlet은 예약된 작업에 작업 트리거를 추가합니다. 이를 사용하여 여러 예약된 작업에 여러 트리거를 추가할 수 있습니다.

작업 트리거는 일회성 또는 되풀이 일정 또는 이벤트가 발생할 때 예약된 작업을 시작합니다.

Add-JobTrigger트리거 매개 변수를 사용하여 추가할 작업 트리거를 식별합니다. Add-JobTrigger이름, ID또는 InputObject 매개 변수를 사용하여 트리거가 추가되는 예약된 작업을 식별합니다.

트리거 매개 변수 값에 대한 작업 트리거를 만들려면 New-JobTrigger cmdlet을 사용하거나 해시 테이블을 사용하여 작업 트리거를 지정합니다.

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

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

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

예제

예제 1: 예약된 작업에 작업 트리거 추가

PS C:\> $Daily = New-JobTrigger -Daily -At 3AMPS
PS C:\> Add-JobTrigger -Trigger $Daily -Name "TestJob"

이러한 명령은 매일 작업 트리거를 TestJob 예약 작업에 추가합니다.

첫 번째 명령은 New-JobTrigger cmdlet을 사용하여 매일 오전 3시 00분에 예약된 작업을 시작하는 작업 트리거를 만듭니다. 이 명령은 작업 트리거를 $Daily 변수에 저장합니다.

두 번째 명령은 Add-JobTrigger cmdlet을 사용하여 $Startup 변수의 작업 트리거를 TestJob 예약 작업에 추가합니다.

예제 2: 예약된 여러 작업에 작업 트리거 추가

PS C:\> Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

이 명령은 로컬 컴퓨터의 모든 예약된 작업에 AtStartup 작업 트리거를 추가합니다. Get-ScheduledJob 사용하여 컴퓨터에서 예약된 모든 작업을 가져옵니다. 파이프라인 연산자(|)를 사용하여 예약된 각 작업에 작업 트리거를 추가하는 Add-JobTrigger cmdlet으로 작업을 보냅니다. 트리거 매개 변수의 값은 AtStartup 작업 트리거를 만드는 New-JobTrigger 명령입니다.

예제 3: 작업 트리거 복사

PS C:\> $T = Get-JobTrigger -Name "BackupArchives"
PS C:\> Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

이러한 명령은 BackupArchives 예약된 작업에서 작업 트리거를 복사하고 TestBackup 및 BackupLogs 예약된 작업에 추가합니다.

첫 번째 명령은 Get-JobTrigger cmdlet을 사용하여 BackupArchives 예약 작업의 작업 트리거를 가져옵니다. 이 명령은 트리거를 $t 변수에 저장합니다.

두 번째 명령은 Add-JobTrigger cmdlet을 사용하여 $t 작업 트리거를 TestBackup 및 BackupLogs 예약된 작업에 추가합니다.

매개 변수

-Id

예약된 작업의 ID 번호를 지정합니다. Add-JobTrigger 지정된 예약된 작업에 작업 트리거를 추가합니다.

로컬 컴퓨터 또는 원격 컴퓨터에서 예약된 작업의 ID 번호를 얻으려면 Get-ScheduledJob cmdlet을 사용합니다.

형식:Int32[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

예약된 작업을 지정합니다. ScheduledJob 개체가 포함된 변수를 입력하거나 Get-ScheduledJob 명령과 같이 ScheduledJob 개체를 가져오는 명령이나 식을 입력합니다. ScheduledJob 개체를 Add-JobTrigger파이프할 수도 있습니다.

형식:ScheduledJobDefinition[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

예약된 작업의 이름을 지정합니다. Add-JobTrigger 지정된 예약된 작업에 작업 트리거를 추가합니다. 와일드카드가 지원됩니다.

로컬 컴퓨터 또는 원격 컴퓨터에서 예약된 작업의 이름을 얻으려면 Get-ScheduledJob cmdlet을 사용합니다.

형식:String[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Trigger

추가할 작업 트리거를 지정합니다. 작업 트리거 또는 ScheduledJobTrigger 개체를 포함하는 변수를 지정하는 해시 테이블을 입력하거나 Get-JobTrigger 명령과 같이 ScheduledJobTrigger 개체를 가져오는 명령이나 식을 입력합니다. ScheduledJobTrigger 개체를 Add-JobTrigger파이프할 수도 있습니다.

형식:ScheduledJobTrigger[]
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger, Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

작업 트리거 또는 예약된 작업을 Add-JobTrigger파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.