Sdílet prostřednictvím


New-AzAutomationSchedule

Vytvoří plán automatizace.

Syntaxe

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

Rutina New-AzAutomationSchedule 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

$TimeZone = ([System.TimeZoneInfo]::Local).Id
New-AzAutomationSchedule -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í jednou v aktuálním datu v 11:00 v zadaném časovém pásmu.

Příklad 2: Vytvoření jednorázového plánu v jiném časovém pásmu

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

První příkaz inicializuje proměnnou $TimeZone s hodnotou Europe/Paris . Druhý příkaz vytvoří plán, který se spustí jednou v aktuálním datu v 23:00 UTC v zadaném časovém pásmu.

Poznámka: Čas zahájení plánu se vypočítá přidáním posunu časového pásma do zadaného času StartTime.

Příklad 3: Vytvoření plánu opakování

$StartTime = Get-Date "13:00:00"
$EndTime = $StartTime.AddYears(1)
New-AzAutomationSchedule -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 4: Vytvoření týdenního opakovaného plánu

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

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:AzContext, 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 DateTimeOffset . 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 k dispozici časové pásmo, počáteční čas se vypočítá přidáním posunu vstupního časového pásma.

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

Vstupy

String

DateTimeOffset

SwitchParameter

Výstupy

Schedule