New-AzAutomationSchedule

모듈:

Az.Automation

Automation 일정을 만듭니다.

구문

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -DayInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfWeek <DayOfWeek[]>]
   [-ExpiryTime <DateTimeOffset>]
   -WeekInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfMonth <DaysOfMonth[]>]
   [-ExpiryTime <DateTimeOffset>]
   -MonthInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DayOfWeek <DayOfWeek>]
   [-DayOfWeekOccurrence <DayOfWeekOccurrence>]
   [-ExpiryTime <DateTimeOffset>]
   -MonthInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-OneTime]
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -HourInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

New-AzAutomationSchedule cmdlet은 Azure Automation에서 일정을 만듭니다.

예제

예제 1: 현지 시간으로 일회성 일정 만들기

$TimeZone = ([System.TimeZoneInfo]::Local).Id
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone

첫 번째 명령은 시스템에서 표준 시간대 ID를 가져오고 $TimeZone 변수에 저장합니다. 두 번째 명령은 지정된 표준 시간대에서 현재 날짜 11:00 PM에 한 번 실행되는 일정을 만듭니다.

예제 2: 다른 표준 시간대에 일회성 일정 만들기

$TimeZone = "Europe/Paris"
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00Z" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone

첫 번째 명령은 값을 Europe/Paris 사용하여 $TimeZone 변수를 초기화합니다. 두 번째 명령은 지정된 표준 시간대의 현재 날짜 23:00 UTC에서 한 번 실행되는 일정을 만듭니다.

참고: Schedule StartTime은 제공된 StartTime 에 표준 시간대 오프셋을 추가하여 계산됩니다 .

예제 3: 되풀이 일정 만들기

$StartTime = Get-Date "13:00:00"
$EndTime = $StartTime.AddYears(1)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DayInterval 1 -ResourceGroupName "ResourceGroup01"

첫 번째 명령은 Get-Date cmdlet을 사용하여 날짜 개체를 만든 다음 개체를 $StartDate 변수에 저장합니다. 나중에 5분 이상 걸리는 시간을 지정합니다. 두 번째 명령은 Get-Date cmdlet을 사용하여 날짜 개체를 만든 다음 개체를 $EndDate 변수에 저장합니다. 이 명령은 미래의 시간을 지정합니다. 최종 명령은 Schedule02라는 일일 일정을 만들어 $StartDate 저장된 시간에 시작하고 $EndDate 저장된 시간에 만료됩니다.

예제 4: 매주 되풀이 일정 만들기

$StartTime = (Get-Date "13:00:00").AddDays(1)
[System.DayOfWeek[]]$WeekDays = @([System.DayOfWeek]::Monday..[System.DayOfWeek]::Friday)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule03" -StartTime $StartTime -WeekInterval 1 -DaysOfWeek $WeekDays -ResourceGroupName "ResourceGroup01"

첫 번째 명령은 Get-Date cmdlet을 사용하여 날짜 개체를 만든 다음 개체를 $StartDate 변수에 저장합니다. 두 번째 명령은 월요일, 화요일, 수요일, 목요일 및 금요일을 포함하는 요일 배열을 만듭니다. 최종 명령은 매주 월요일에서 금요일까지 매주 13:00에 실행되는 Schedule03이라는 일일 일정을 만듭니다. 일정은 만료되지 않습니다.

매개 변수

-AutomationAccountName

이 cmdlet이 일정을 만드는 Automation 계정의 이름을 지정합니다.

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

-DayInterval

일정에 대한 간격(일)을 지정합니다. 이 매개 변수를 지정하지 않고 OneTime 매개 변수를 지정하지 않으면 기본값은 1입니다.

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

-DayOfWeek

주간 일정의 요일 목록을 지정합니다.

형식:	Nullable<T>[DayOfWeek]
허용되는 값:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DayOfWeekOccurrence

일정이 실행되는 월 내 주의 발생을 지정합니다. psdx_paramvalues

• 1
• 2
• 3
• 4
• -1
• 첫 번째
• 두 번째
• 세 번째
• 네 번째
• LastDay

형식:	DayOfWeekOccurrence
허용되는 값:	First, Second, Third, Fourth, Last
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DaysOfMonth

월별 일정에 대한 월의 일 목록을 지정합니다.

형식:	DaysOfMonth[]
허용되는 값:	One, Two, Three, Four, Five, Six, Seventh, Eighth, Ninth, Tenth, Eleventh, Twelfth, Thirteenth, Fourteenth, Fifteenth, Sixteenth, Seventeenth, Eighteenth, Nineteenth, Twentieth, TwentyFirst, TwentySecond, TwentyThird, TwentyFourth, TwentyFifth, TwentySixth, TwentySeventh, TwentyEighth, TwentyNinth, Thirtieth, ThirtyFirst, LastDay
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DaysOfWeek

주간 일정의 요일 목록을 지정합니다.

형식:	DayOfWeek[]
허용되는 값:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:	IAzureContextContainer
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Description

일정에 대한 설명을 지정합니다.

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

-ExpiryTime

일정의 만료 시간을 DateTimeOffset 개체로 지정합니다. 유효한 DateTimeOffset으로 변환할 수 있는 문자열을 지정할 수 있습니다.

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

-ForUpdateConfiguration

이 일정 개체가 소프트웨어 업데이트 구성 예약에 사용됨을 나타냅니다.

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

-HourInterval

일정에 대한 간격(시간)을 지정합니다.

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

-MonthInterval

일정에 대한 간격(월)을 지정합니다.

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

-Name

일정의 이름을 지정합니다.

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

-OneTime

cmdlet이 일회성 일정을 만들게 지정합니다.

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

-ResourceGroupName

이 cmdlet이 일정을 만드는 리소스 그룹의 이름을 지정합니다.

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

-StartTime

일정의 시작 시간을 DateTimeOffset 개체로 지정합니다. 유효한 DateTimeOffset으로 변환할 수 있는 문자열을 지정할 수 있습니다. TimeZone이 제공되면 StartTime은 입력 표준 시간대의 오프셋을 추가하여 계산됩니다.

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

-TimeZone

일정의 표준 시간대를 지정합니다. 이 문자열은 IANA ID 또는 Windows 표준 시간대 ID일 수 있습니다.

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

-WeekInterval

일정에 대한 간격(주)을 지정합니다.

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

입력

String

DateTimeOffset

SwitchParameter

출력

Schedule

관련 링크

• Get-AzAutomationSchedule
• Remove-AzAutomationSchedule
• Set-AzAutomationSchedule