New-ScheduledJobOption

구문

New-ScheduledJobOption
   [-RunElevated]
   [-HideInTaskScheduler]
   [-RestartOnIdleResume]
   [-MultipleInstancePolicy <TaskMultipleInstancePolicy>]
   [-DoNotAllowDemandStart]
   [-RequireNetwork]
   [-StopIfGoingOffIdle]
   [-WakeToRun]
   [-ContinueIfGoingOnBattery]
   [-StartIfOnBattery]
   [-IdleTimeout <TimeSpan>]
   [-IdleDuration <TimeSpan>]
   [-StartIfIdle]
   [<CommonParameters>]

Description

cmdlet은 New-ScheduledJobOption 예약된 작업에 대한 고급 옵션을 포함하는 개체를 만듭니다.

반환되는 ScheduledJobOptions 개체 New-ScheduledJobOption 를 사용하여 새 작업 또는 기존 예약된 작업에 대한 작업 옵션을 설정할 수 있습니다. 또는 cmdlet을 사용하여 Get-ScheduledJobOption 기존 예약된 작업의 작업 옵션을 얻거나 해시 테이블 값을 사용하여 작업 옵션을 표시하여 작업 옵션을 설정할 수 있습니다.

매개 변수 New-ScheduledJobOption 가 없으면 모든 옵션에 대한 기본값을 포함하는 개체를 생성합니다. JobDefinition 속성을 제외한 모든 속성을 편집할 수 있으므로 결과 개체를 템플릿으로 사용하고 엔터프라이즈에 대한 표준 옵션 개체를 만들 수 있습니다.

예약된 작업을 만들고 예약된 작업 옵션을 설정할 때 모든 예약된 작업 옵션의 기본값을 검토합니다. 예약된 작업은 실행에 대해 설정된 모든 조건이 충족되는 경우에만 실행됩니다.

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

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

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

예제

예제 1: 기본값을 사용하여 예약된 작업 옵션 개체 만들기

다음은 기본값을 사용하여 예약된 작업 옵션 개체를 만드는 예제입니다.

New-ScheduledJobOption

예제 2: 사용자 지정 값을 사용하여 예약된 작업 옵션 개체 만들기

이 예제에서는 사용자 지정 값을 사용하여 예약된 작업 옵션 개체를 만듭니다.

New-ScheduledJobOption -RequireNetwork -StartIfOnBattery

StartIfOnBatteries     : True
StopIfGoingOnBatteries : True
WakeToRun              : False
StartIfNotIdle         : True
StopIfGoingOffIdle     : False
RestartOnIdleResume    : False
IdleDuration           : 00:10:00
IdleTimeout            : 01:00:00
ShowInTaskScheduler    : True
RunElevated            : False
RunWithoutNetwork      : False
DoNotAllowDemandStart  : False
MultipleInstancePolicy : Ignore
NewJobDefinition       :

다음 명령은 네트워크가 필요한 예약된 작업 개체를 만들고 컴퓨터가 AC 전원에 연결되지 않은 경우에도 예약된 작업을 실행합니다.

출력은 RequireNetwork 매개 변수가 RunWithoutNetwork 속성 $false 의 값을 변경하고 StartIfOnBattery 매개 변수가 StartIfOnBatteries 속성의 값을 변경했음을 $true보여줍니다.

예제 3: 새 예약된 작업에 대한 옵션 설정

이 예제에서는 새 예약된 작업에 대한 옵션을 설정하기 위해 반환되는 New-ScheduledJobOption ScheduledJobOptions 개체를 사용하는 방법을 보여 줍니다.

$runAsAdmin = New-ScheduledJobOption -RunElevated
Register-ScheduledJob -Name Backup -FilePath D:\Scripts\Backup.ps1 -Trigger $Mondays -ScheduledJobOption $RunAsAdmin
Get-ScheduledJobOption -Name Backup

StartIfOnBatteries     : False
StopIfGoingOnBatteries : True
WakeToRun              : False
StartIfNotIdle         : True
StopIfGoingOffIdle     : False
RestartOnIdleResume    : False
IdleDuration           : 00:10:00
IdleTimeout            : 01:00:00
ShowInTaskScheduler    : True
RunElevated            : True
RunWithoutNetwork      : True
DoNotAllowDemandStart  : False
MultipleInstancePolicy : IgnoreNew
JobDefinition          : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

첫 번째 명령은 RunElevated 매개 변수를 사용하여 ScheduledJobOptions 개체를 만듭니다. 변수에 개체를 $runAsAdmin 저장합니다.

두 번째 명령은 cmdlet을 Register-ScheduledJob 사용하여 예약된 새 작업을 만듭니다. ScheduledJobOption 매개 변수의 값은 변수 값의 $runAsAdmin 옵션 개체입니다.

세 번째 명령은 cmdlet을 Get-ScheduledJobOption 사용하여 예약된 백업 작업의 작업 옵션을 가져옵니다. cmdlet 출력은 RunElevated 속성이 설정 $true 되고 작업 옵션 개체의 JobDefinition 속성이 예약된 백업 작업의 예약된 작업 개체로 채워져 있음을 보여줍니다.

예제 4: 예약된 작업 옵션 개체의 속성 정렬

이 예제에서는 읽기 쉽도록 ScheduledJobOptions 개체의 속성을 사전순으로 정렬하는 방법을 보여 줍니다.

$options = New-ScheduledJobOption -WakeToRun
$options.PSObject.Properties | Sort-Object -Property Name | Format-Table -Property Name, Value -Autosize

Name                       Value
----                       -----
DoNotAllowDemandStart      False
IdleDuration            00:10:00
IdleTimeout             01:00:00
JobDefinition
MultipleInstancePolicy IgnoreNew
RestartOnIdleResume        False
RunElevated                False
RunWithoutNetwork           True
ShowInTaskScheduler         True
StartIfNotIdle              True
StartIfOnBatteries         False
StopIfGoingOffIdle         False
StopIfGoingOnBatteries      True
WakeToRun                   True

첫 번째 명령은 cmdlet을 New-ScheduledJobOption 사용하여 ScheduledJobOptions 개체를 만듭니다. 이 명령은 WakeToRun 매개 변수를 사용하고 결과 개체를 변수에 $options 저장합니다.

$Options 속성을 개체로 가져오기 위해 두 번째 명령은 모든 Windows PowerShell 개체의 PSObject 속성과 해당 속성 속성을 사용합니다. 그런 다음 이 명령은 속성 개체를 cmdlet으로 Sort-Object 파이프하여 이름을 기준으로 속성을 사전순으로 정렬한 다음 Format-Table , 표에 있는 속성의 이름과 값을 표시하는 cmdlet으로 파이프합니다.

이 형식을 사용하면 ScheduledJobOptions 개체 $options 의 WakeToRun 속성을 훨씬 쉽게 찾고 해당 값이 변경되었는지 $false 확인할 수 $true있습니다.

매개 변수

-ContinueIfGoingOnBattery

-DoNotAllowDemandStart

-HideInTaskScheduler

-IdleDuration

-IdleTimeout

-MultipleInstancePolicy

-RequireNetwork

-RestartOnIdleResume

-RunElevated

-StartIfIdle

-StartIfOnBattery

-StopIfGoingOffIdle

-WakeToRun

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

ScheduledJobOptions

이 cmdlet은 만든 옵션을 나타내는 ScheduledJobOptions 개체를 반환합니다.

참고

• cmdlet의 ScheduledJobOption 매개 변수 값으로 만드는 ScheduledJobOptions 개체 New-ScheduledJobOption 를 Register-ScheduledJob 사용할 수 있습니다. 그러나 ScheduledJobOption 매개 변수는 ScheduledJobOptions 개체의 속성과 해당 값을 지정하는 해시 테이블 값을 사용할 수도 있습니다. 예를 들면 다음과 같습니다.

  @{ShowInTaskScheduler=$False; RunElevated=$True; IdleDuration="00:05"}

관련 링크

• 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