다음을 통해 공유

Remove-JobTrigger

  • 참조
모듈:
PSScheduledJob

예약된 작업에서 작업 트리거를 삭제합니다.

구문

Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-InputObject] <ScheduledJobDefinition[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Name] <String[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Id] <Int32[]>
      [<CommonParameters>]

Description

Remove-JobTrigger cmdlet은 예약된 작업에서 작업 트리거를 삭제합니다.

작업 트리거는 예약된 작업을 시작하기 위한 되풀이 일정 또는 조건을 정의합니다. 작업 트리거를 관리하려면 New-JobTrigger, Add-JobTrigger, Set-JobTrigger 및 Set-ScheduledJob cmdlet을 사용합니다.

Remove-JobTrigger이름, ID또는 InputObject 매개 변수를 사용하여 트리거가 제거되는 예약된 작업을 식별합니다. TriggerID 매개 변수를 사용하여 삭제할 작업 트리거를 식별합니다. 기본적으로 Remove-JobTrigger 예약된 작업의 모든 작업 트리거를 삭제합니다.

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

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

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

예제

예제 1: 모든 작업 트리거 삭제

PS C:\> Remove-JobTrigger -Name "Test*"

이 명령은 Test로 시작하는 이름이 있는 예약된 작업에서 모든 작업 트리거를 삭제합니다.

예제 2: 선택한 작업 트리거 삭제

PS C:\> Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

이 명령은 BackupArchive 예약 작업에서 세 번째 트리거(ID = 3)만 삭제합니다.

예제 3: 예약된 모든 작업에서 AtStartup 작업 트리거 삭제

PS C:\> function Delete-AtStartup
{
    Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.Frequency -eq "AtStartup"} | ForEach-Object { Remove-JobTrigger -InputObject $_.JobDefinition -TriggerID $_.ID}
}

이 함수는 로컬 컴퓨터의 모든 작업에서 모든 AtStartup 작업 트리거를 삭제합니다. 함수를 사용하려면 세션에서 함수를 실행한 다음 Delete-AtStartup입력합니다.

Delete-AtStartup 함수에는 단일 명령이 포함되어 있습니다. 이 명령은 Get-ScheduledJob cmdlet을 사용하여 로컬 컴퓨터에서 예약된 작업을 가져옵니다. 파이프라인 연산자(|)는 예약된 작업을 Get-JobTrigger cmdlet으로 보내며, 이 cmdlet은 예약된 각 작업에서 모든 작업 트리거를 가져옵니다. 파이프라인 연산자는 작업 트리거를 Where-Object cmdlet으로 보냅니다. 이 cmdlet은 작업 트리거의 Frequency 속성 값이 AtStartup과 같은 작업 트리거를 선택합니다.

JobTrigger 개체에는 트리거하는 예약된 작업이 포함된 JobDefinition 속성이 있습니다. 명령의 나머지 부분에서는 이 중요한 기능을 사용합니다.

파이프라인 연산자는 각 AtStartup 트리거에서 Remove-JobTrigger 명령을 실행하는 ForEach-Object cmdlet에 AtStartup 작업 트리거를 보냅니다. Remove-JobTriggerInputObject 매개 변수의 값은 작업 트리거의 JobDefinition 속성에서 예약된 작업입니다. TriggerID 매개 변수의 값은 작업 트리거의 ID 속성에 있는 식별자입니다.

예제 4: 원격 예약 작업에서 작업 트리거 삭제

PS C:\> Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

이 명령은 Server01 컴퓨터의 인벤토리 작업에서 첫 번째 작업 트리거를 삭제합니다.

이 명령은 Invoke-Command cmdlet을 사용하여 Server01 컴퓨터에서 Remove-JobTrigger cmdlet을 실행합니다. Remove-JobTrigger cmdlet은 ID 매개 변수를 사용하여 인벤토리 예약 작업 및 TriggerID 매개 변수를 식별하여 첫 번째 트리거를 지정합니다. ID 매개 변수는 예약된 여러 작업의 이름이 동일하거나 유사한 경우에 특히 유용합니다.

매개 변수

-Id

예약된 작업의 ID 번호를 지정합니다. Remove-JobTrigger 지정된 예약된 작업에서 작업 트리거를 삭제합니다.

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

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

-InputObject

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

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

-Name

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

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

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

-TriggerId

지정된 작업 트리거만 삭제합니다. 기본적으로 remove-JobTrigger 예약된 작업에서 모든 트리거를 삭제합니다. 예약된 작업에 여러 작업 트리거가 있는 경우 이 매개 변수를 사용합니다.

예약된 작업의 하나 이상의 작업 트리거에 대한 트리거 ID를 입력합니다. 여러 예약된 작업을 지정하는 경우 Remove-JobTrigger 예약된 모든 작업에서 지정된 ID를 사용하여 작업 트리거를 삭제합니다.

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

입력

ScheduledJobDefinition

예약된 작업을 Remove-JobTrigger cmdlet으로 파이프할 수 있습니다.

출력

None

cmdlet은 출력을 생성하지 않습니다.