New-AzureRMAutomationSchedule

Module:

AzureRM.Automation

Hiermee maakt u een Automation-planning.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

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

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

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

New-AzureRMAutomationSchedule
   [-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-AzureRMAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-OneTime]
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureRMAutomationSchedule
   [-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-AzureRmAutomationSchedule maakt u een schema in Azure Automation.

Voorbeelden

Voorbeeld 1: Een eenmalige planning maken in lokale tijd

PS C:\> $TimeZone = ([System.TimeZoneInfo]::Local).Id
PS C:\> New-AzureRmAutomationSchedule -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 terugkerend schema maken

PS C:\> $StartTime = Get-Date "13:00:00"
PS C:\> $EndTime = $StartTime.AddYears(1)
PS C:\> New-AzureRmAutomationSchedule -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 3: Een wekelijks terugkerend schema maken

PS C:\> $StartTime = (Get-Date "13:00:00").AddDays(1)
PS C:\> [System.DayOfWeek[]]$WeekDays = @([System.DayOfWeek]::Monday..[System.DayOfWeek]::Friday)
PS C:\> New-AzureRmAutomationSchedule -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:	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 planning op als een DateTimeOffest-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 parameter TimeZone is opgegeven, wordt de offset genegeerd en wordt de opgegeven tijdzone gebruikt.

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

Uitvoerwaarden

Schedule

Verwante koppelingen

• Get-AzureRmAutomationSchedule
• Remove-AzureRmAutomationSchedule
• Set-AzureRmAutomationSchedule