New-AzAutomationSchedule

Modul:

Az.Automation

Skapar ett Automation-schema.

Syntax

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

Cmdleten New-AzAutomationSchedule skapar ett schema i Azure Automation.

Exempel

Exempel 1: Skapa ett engångsschema i lokal tid

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

Det första kommandot hämtar tidszons-ID:t från systemet och lagrar det i variabeln $TimeZone. Det andra kommandot skapar ett schema som körs en gång på det aktuella datumet kl. 23:00 i den angivna tidszonen.

Exempel 2: Skapa ett engångsschema i en annan tidszon

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

Det första kommandot initierar en $TimeZone variabel med värdet Europe/Paris Det andra kommandot skapar ett schema som körs en gång på det aktuella datumet kl. 23:00 UTC i den angivna tidszonen.

Obs! Schemastarttid beräknas genom att timezone-förskjutningen läggs till i starttid

Exempel 3: Skapa ett återkommande schema

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

Det första kommandot skapar ett datumobjekt med cmdleten Get-Date och lagrar sedan objektet i variabeln $StartDate. Ange en tid som är minst fem minuter i framtiden. Det andra kommandot skapar ett datumobjekt med cmdleten Get-Date och lagrar sedan objektet i variabeln $EndDate. Kommandot anger en framtida tid. Det sista kommandot skapar ett dagligt schema med namnet Schedule02 för att börja vid den tidpunkt som lagras i $StartDate och förfaller vid den tidpunkt som lagras i $EndDate.

Exempel 4: Skapa ett återkommande veckoschema

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

Det första kommandot skapar ett datumobjekt med cmdleten Get-Date och lagrar sedan objektet i variabeln $StartDate. Det andra kommandot skapar en matris med veckodagar som innehåller måndag, tisdag, onsdag, torsdag och fredag. Det slutliga kommandot skapar ett dagligt schema med namnet Schedule03 som körs måndag till fredag varje vecka kl. 13:00. Schemat upphör aldrig att gälla.

Parametrar

-AutomationAccountName

Anger namnet på ett Automation-konto som den här cmdleten skapar ett schema för.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DayInterval

Anger ett intervall i dagar för schemat. Om du inte anger den här parametern och du inte anger parametern OneTime är standardvärdet ett (1).

Type:	Byte
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DayOfWeek

Anger en lista över veckodagar för veckoschemat.

Type:	Nullable<T>[DayOfWeek]
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DayOfWeekOccurrence

Anger förekomsten av veckan inom den månad som schemat körs. psdx_paramvalues

• 1
• 2
• 3
• 4
• -1
• First
• Second
• Tredje
• Fjärde
• LastDay

Type:	DayOfWeekOccurrence
Accepted values:	First, Second, Third, Fourth, Last
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysOfMonth

Anger en lista över dagar i månaden för månadsschemat.

Type:	DaysOfMonth[]
Accepted values:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysOfWeek

Anger en lista över veckodagar för veckoschemat.

Type:	DayOfWeek[]
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Anger en beskrivning av schemat.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExpiryTime

Anger förfallotiden för ett schema som ett DateTimeOffset-objekt . Du kan ange en sträng som kan konverteras till en giltig DateTimeOffset.

Type:	DateTimeOffset
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForUpdateConfiguration

Anger att det här schemaobjektet kommer att användas för att schemalägga en programuppdateringskonfiguration

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-HourInterval

Anger ett intervall i timmar för schemat.

Type:	Byte
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthInterval

Anger ett intervall, i Månader, för schemat.

Type:	Byte
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Anger ett namn för schemat.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-OneTime

Anger att cmdleten skapar ett engångsschema.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Anger namnet på en resursgrupp som den här cmdleten skapar ett schema för.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StartTime

Anger starttiden för ett schema som ett DateTimeOffset-objekt . Du kan ange en sträng som kan konverteras till en giltig DateTimeOffset. Om tidszonen anges beräknas StartTime genom att lägga till förskjutningen av indatatidszonen.

Type:	DateTimeOffset
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TimeZone

Anger tidszonen för schemat. Den här strängen kan vara IANA-ID eller Windows tidszons-ID.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WeekInterval

Anger ett intervall, i veckor, för schemat.

Type:	Byte
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

String

DateTimeOffset

SwitchParameter

Utdata

Schedule

Relaterade länkar

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