New-AzAutomationSchedule

Module:

Az.Automation

Hiermee maakt u een Automation-planning.

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

Met de cmdlet New-AzAutomationSchedule maakt u een planning in Azure Automation.

Voorbeelden

Voorbeeld 1: Een eenmalige planning maken in lokale tijd

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

Met de eerste opdracht wordt de tijdzone-id opgehaald uit het systeem en opgeslagen in de $TimeZone variabele. Met de tweede opdracht maakt u een schema dat één keer wordt uitgevoerd op de huidige datum om 11:00 uur in de opgegeven tijdzone.

Voorbeeld 2: Een eenmalig schema maken in een andere tijdzone

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

Met de eerste opdracht wordt een $TimeZone variabele geïnitialiseerd met de waarde Europe/Paris De tweede opdracht maakt een schema dat één keer wordt uitgevoerd op de huidige datum om 23:00 UTC in de opgegeven tijdzone.

Opmerking: StartTime plannen wordt berekend door de Tijdzone-offset toe te voegen aan opgegeven StartTime

Voorbeeld 3: Een terugkerend schema maken

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

Met de eerste opdracht maakt u een datumobject met behulp van de cmdlet Get-Date en slaat u het object vervolgens op in de $StartDate variabele. Geef een tijd op die ten minste vijf minuten in de toekomst is. Met de tweede opdracht maakt u een datumobject met behulp van de cmdlet Get-Date en slaat u het object vervolgens op in de $EndDate variabele. Met de opdracht wordt een toekomstige tijd opgegeven. Met de laatste opdracht maakt u een dagelijks schema met de naam Schedule02 om te beginnen op het tijdstip dat is opgeslagen in $StartDate en verloopt op het tijdstip dat is opgeslagen in $EndDate.

Voorbeeld 4: Een wekelijks terugkerend schema maken

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

Met de eerste opdracht maakt u een datumobject met behulp van de cmdlet Get-Date en slaat u het object vervolgens op in de $StartDate variabele. Met de tweede opdracht maakt u een matrix van weekdagen die maandag, dinsdag, woensdag, donderdag en vrijdag bevatten. Met de laatste opdracht maakt u een dagelijks schema met de naam Schedule03 dat elke week van maandag tot en met vrijdag om 13:00 uur wordt uitgevoerd. De planning verloopt nooit.

Parameters

-AutomationAccountName

Hiermee geeft u de naam op van een Automation-account waarvoor deze cmdlet een planning maakt.

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

-DayInterval

Hiermee geeft u een interval, in dagen, voor de planning. Als u deze parameter niet opgeeft en u de OneTime-parameter niet opgeeft, is de standaardwaarde er een (1).

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

-DayOfWeek

Hiermee geeft u een lijst met dagen van de week voor de wekelijkse planning.

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

Hiermee geeft u het exemplaar van de week binnen de maand dat de planning wordt uitgevoerd. psdx_paramvalues

• 1
• 2
• 3
• 4
• -1
• First
• Seconde
• Derde
• Vierde
• 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

Hiermee geeft u een lijst met dagen van de maand voor de maandelijkse planning.

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

Hiermee geeft u een lijst met dagen van de week voor de wekelijkse planning.

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

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

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

-Description

Hiermee geeft u een beschrijving voor de planning.

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

-ExpiryTime

Hiermee geeft u de verlooptijd van een schema op als een DateTimeOffset-object . U kunt een tekenreeks opgeven die kan worden geconverteerd naar een geldige DateTimeOffset.

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

-ForUpdateConfiguration

Geeft aan dat dit planningsobject wordt gebruikt voor het plannen van een software-updateconfiguratie

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

-HourInterval

Hiermee geeft u een interval, in uren, voor de planning.

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

-MonthInterval

Hiermee geeft u een interval op, in maanden, voor de planning.

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

-Name

Hiermee geeft u een naam voor de planning.

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

-OneTime

Hiermee geeft u op dat de cmdlet een eenmalig schema maakt.

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

-ResourceGroupName

Hiermee geeft u de naam op van een resourcegroep waarvoor deze cmdlet een planning maakt.

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

-StartTime

Hiermee geeft u de begintijd van een planning op als een DateTimeOffset-object . U kunt een tekenreeks opgeven die kan worden geconverteerd naar een geldige DateTimeOffset. Als de tijdzone is opgegeven, wordt StartTime berekend door de offset van invoertijdzone toe te voegen.

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

-TimeZone

Hiermee geeft u de tijdzone voor de planning. Deze tekenreeks kan de IANA-id of de Windows-tijdzone-id zijn.

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

-WeekInterval

Hiermee geeft u een interval, in weken, voor de planning.

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

Invoerwaarden

String

DateTimeOffset

SwitchParameter

Uitvoerwaarden

Schedule

Verwante koppelingen

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