New-AzAutomationSchedule

Module:

Az.Automation Module

Creates an Automation schedule.

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

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

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

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

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

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

The New-AzAutomationSchedule cmdlet creates a schedule in Azure Automation.

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

The first command gets the time zone ID from the system and stores it in the $TimeZone variable. The second command creates a schedule that runs one time on the current date at 11:00 PM in the specified time zone.

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

The first command initializes a $TimeZone variable with value Europe/Paris The second command creates a schedule that runs one time on the current date at 23:00 UTC in the specified time zone.

Note: Schedule StartTime is calculated by adding the TimeZone Offset to provided StartTime

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

The first command creates a date object by using the Get-Date cmdlet, and then stores the object in the $StartDate variable. Specify a time that is at least five minutes in the future. The second command creates a date object by using the Get-Date cmdlet, and then stores the object in the $EndDate variable. The command specifies a future time. The final command creates a daily schedule named Schedule02 to begin at the time stored in $StartDate and expire at the time stored in $EndDate.

$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"

The first command creates a date object by using the Get-Date cmdlet, and then stores the object in the $StartDate variable. The second command creates an array of week days that contains Monday, Tuesday, Wednesday, Thursday and Friday. The final command creates a daily schedule named Schedule03 that will run Monday to Friday each week at 13:00. The schedule will never expire.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.