Dela via


New-AzAutomationSchedule

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.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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).

Typ:Byte
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DayOfWeek

Anger en lista över veckodagar för veckoschemat.

Typ:Nullable<T>[DayOfWeek]
Godkända värden:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Typ:DayOfWeekOccurrence
Godkända värden:First, Second, Third, Fourth, Last
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DaysOfMonth

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

Typ:DaysOfMonth[]
Godkända värden: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
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DaysOfWeek

Anger en lista över veckodagar för veckoschemat.

Typ:DayOfWeek[]
Godkända värden:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Anger en beskrivning av schemat.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:DateTimeOffset
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ForUpdateConfiguration

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-HourInterval

Anger ett intervall i timmar för schemat.

Typ:Byte
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MonthInterval

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

Typ:Byte
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger ett namn för schemat.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-OneTime

Anger att cmdleten skapar ett engångsschema.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

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

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:DateTimeOffset
Position:3
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TimeZone

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WeekInterval

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

Typ:Byte
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

DateTimeOffset

SwitchParameter

Utdata

Schedule