다음을 통해 공유

Disable-JobTrigger

  • 참조
모듈:
PSScheduledJob

예약된 작업의 작업 트리거를 사용하지 않도록 설정합니다.

구문

Disable-JobTrigger
       [-InputObject] <ScheduledJobTrigger[]>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Disable-JobTrigger cmdlet은 예약된 작업의 작업 트리거를 일시적으로 사용하지 않도록 설정합니다. 사용하지 않도록 설정하면 모든 작업 트리거 속성이 유지되지만 작업 트리거가 예약된 작업을 시작할 수 없습니다.

이 cmdlet을 사용하려면 Get-JobTrigger cmdlet을 사용하여 작업 트리거를 가져옵니다. 그런 다음 작업 트리거를 파이프하여 Disable-JobTrigger InputObject 매개 변수를 사용합니다.

작업 트리거를 사용하지 않도록 설정하려면 Disable-JobTrigger cmdlet은 작업 트리거의 Enabled 속성을 $False 설정합니다. 작업 트리거를 다시 사용하도록 설정하려면 작업 트리거의 Enabled 속성을 $True 설정하는 Enable-JobTrigger cmdlet을 사용합니다. 작업 트리거를 사용하지 않도록 설정해도 Disable-ScheduledJob cmdlet에서 수행하는 것과 같이 예약된 작업이 비활성화되지는 않지만 모든 작업 트리거를 사용하지 않도록 설정하면 예약된 작업을 사용하지 않도록 설정하는 것과 같은 효과가 발생합니다.

예약된 작업을 사용하지 않도록 설정하거나 예약된 작업의 모든 작업 트리거를 사용하지 않도록 설정하는 경우에도 Start-Job cmdlet을 사용하여 작업을 시작하거나 사용하지 않도록 설정된 예약된 작업을 템플릿으로 사용할 수 있습니다.

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

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

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

예제

예제 1: 작업 트리거 사용 안 함

PS C:\> Get-JobTrigger -Name "Backup-Archives" -TriggerID 1 | Disable-JobTrigger

이 명령은 로컬 컴퓨터에서 예약된 Backup-Archives 작업의 첫 번째 트리거(ID=1)를 사용하지 않도록 설정합니다.

이 명령은 Get-JobTrigger cmdlet을 사용하여 작업 트리거를 가져옵니다. 파이프라인 연산자는 작업 트리거를 Disable-JobTrigger cmdlet으로 전송하여 이를 사용하지 않도록 설정합니다.

예제 2: 모든 작업 트리거 사용 안 함

The first command uses the Get-ScheduledJob cmdlet to get the Backup-Archives and Inventory scheduled jobs. A pipeline operator (|) sends the scheduled jobs to the Get-JobTrigger cmdlet, which gets all job triggers of the scheduled jobs. Another pipeline operator sends the job triggers to the **Disable-JobTrigger** cmdlet, which disables them.The first command uses the **Get-ScheduledJob** cmdlet to get the jobs, because its *Name* parameter takes multiple names.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger

The second command displays the results. The command repeats the **Get-ScheduledJob** and **Get-JobTrigger** command. A pipeline operator sends the job triggers to the Format-Table cmdlet, which displays the job triggers in a table. The **Format-Table** command adds a JobName property that displays the value of the Name property of the scheduled job in the JobDefinition property of the job trigger object.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}} -AutoSize
Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
1  Weekly    9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
2  Daily     9/29/2011 1:00:00 AM              False   Backup-Archive
1  Weekly    10/20/2011 11:00:00 PM {Friday}   False   Inventory
1  Weekly    11/2/2011 2:00:00 PM   {Monday}   False   Inventory

이러한 명령은 예약된 두 작업에서 모든 작업 트리거를 사용하지 않도록 설정하고 결과를 표시합니다.

예제 3: 원격 컴퓨터에서 예약된 작업의 작업 트리거 사용 안 함

PS C:\> Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "Daily"} | Disable-JobTrigger}

이 명령은 Server01 원격 컴퓨터의 DeployPackage 예약된 작업에서 매일 작업 트리거를 사용하지 않도록 설정합니다.

이 명령은 Invoke-Command cmdlet을 사용하여 Server01 컴퓨터에서 명령을 실행합니다. 원격 명령은 Get-JobTrigger cmdlet을 사용하여 DeployPackage 예약 작업의 작업 트리거를 가져옵니다. 파이프라인 연산자는 작업 트리거를 매일 작업 트리거만 반환하는 Where-Object cmdlet으로 보냅니다. 파이프라인 연산자는 일별 작업 트리거를 Disable-JobTrigger cmdlet으로 전송하여 사용하지 않도록 설정합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

사용하지 않도록 설정할 작업 트리거를 지정합니다. ScheduledJobTrigger 개체를 포함하는 변수를 입력하거나 Get-JobTrigger 명령과 같이 ScheduledJobTrigger 개체를 가져오는 명령이나 식을 입력합니다. ScheduledJobTrigger 개체를 disable-JobTrigger파이프할 수도 있습니다.

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

ScheduledJobTrigger

작업 트리거를 disable-JobTrigger파이프할 수 있습니다.

출력

None

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

참고

  • Disable-JobTrigger 이미 사용하지 않도록 설정된 작업 트리거를 사용하지 않도록 설정하면 오류 또는 경고를 생성하지 않습니다.