New-AzureRMAutomationSchedule
Vytvoří plán automatizace.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntaxe
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
Rutina New-AzureRmAutomationSchedule vytvoří plán ve službě Azure Automation.
Příklady
Příklad 1: Vytvoření jednorázového plánu v místním čase
PS C:\> $TimeZone = ([System.TimeZoneInfo]::Local).Id
PS C:\> New-AzureRmAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone
První příkaz získá ID časového pásma ze systému a uloží ho do proměnné $TimeZone. Druhý příkaz vytvoří plán, který se spustí jednorázově k aktuálnímu datu v 11:00 v zadaném časovém pásmu.
Příklad 2: Vytvoření plánu opakování
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"
První příkaz vytvoří objekt data pomocí rutiny Get-Date a pak uloží objekt do $StartDate proměnné. Zadejte čas, který bude v budoucnu aspoň pět minut. Druhý příkaz vytvoří objekt data pomocí rutiny Get-Date a pak uloží objekt do proměnné $EndDate. Příkaz určuje budoucí čas. Poslední příkaz vytvoří denní plán s názvem Schedule02, který začne v čase uloženém v $StartDate a vyprší v čase uloženém v $EndDate.
Příklad 3: Vytvoření týdenního opakovaného plánu
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"
První příkaz vytvoří objekt data pomocí rutiny Get-Date a pak uloží objekt do $StartDate proměnné. Druhý příkaz vytvoří pole dnů v týdnu, které obsahuje pondělí, úterý, středu, čtvrtek a pátek. Poslední příkaz vytvoří denní plán s názvem Schedule03, který bude každý týden spouštět pondělí až pátek v 13:00. Plán nikdy nevyprší.
Parametry
-AutomationAccountName
Určuje název účtu Automation, pro který tato rutina vytvoří plán.
Typ: | String |
Position: | 1 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DayInterval
Určuje interval pro plán ve dnech. Pokud tento parametr nezadáte a nezadáte parametr OneTime , výchozí hodnota je jedna (1).
Typ: | Byte |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DayOfWeek
Určuje seznam dnů v týdnu pro týdenní plán.
Typ: | Nullable<T>[DayOfWeek] |
Přípustné hodnoty: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DayOfWeekOccurrence
Určuje výskyt týdne v měsíci, ve kterém se plán spouští. psdx_paramvalues
- 1
- 2
- 3
- 4
- -1
- První
- Second
- Třetí
- Čtvrtý
- Poslední den
Typ: | DayOfWeekOccurrence |
Přípustné hodnoty: | First, Second, Third, Fourth, Last |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DaysOfMonth
Určuje seznam dnů v měsíci pro měsíční plán.
Typ: | DaysOfMonth[] |
Přípustné hodnoty: | 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 |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DaysOfWeek
Určuje seznam dnů v týdnu pro týdenní plán.
Typ: | DayOfWeek[] |
Přípustné hodnoty: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
Typ: | IAzureContextContainer |
Aliasy: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Description
Určuje popis plánu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ExpiryTime
Určuje dobu vypršení platnosti plánu jako objekt DateTimeOffest . Můžete zadat řetězec, který lze převést na platný DateTimeOffset.
Typ: | DateTimeOffset |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ForUpdateConfiguration
Označuje, že tento objekt plánu se použije k naplánování konfigurace aktualizace softwaru.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-HourInterval
Určuje interval v hodinách pro plán.
Typ: | Byte |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-MonthInterval
Určuje interval v měsících pro plán.
Typ: | Byte |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Name
Určuje název plánu.
Typ: | String |
Position: | 2 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-OneTime
Určuje, že rutina vytvoří jednorázový plán.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ResourceGroupName
Určuje název skupiny prostředků, pro kterou tato rutina vytvoří plán.
Typ: | String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-StartTime
Určuje počáteční čas plánu jako DateTimeOffset objektu. Můžete zadat řetězec, který lze převést na platný DateTimeOffset. Pokud je zadaný parametr TimeZone, posun se ignoruje a použije se zadané časové pásmo.
Typ: | DateTimeOffset |
Position: | 3 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-TimeZone
Určuje časové pásmo plánu. Tento řetězec může být ID IANA nebo ID časového pásma systému Windows.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-WeekInterval
Určuje interval v týdnech pro plán.
Typ: | Byte |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |