Dela via

New-AzAutomationSchedule

Modul:
Az.Automation Module

Skapar ett Automation-schema.

Syntax

ByDaily (Standard) 

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

ByWeekly 

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

ByMonthlyDaysOfMonth 

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

ByMonthlyDayOfWeek 

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

ByOneTime 

New-AzAutomationSchedule
    [-Name] <String>
    [-StartTime] <DateTimeOffset>
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    [-Description <String>]
    [-OneTime]
    [-TimeZone <String>]
    [-ForUpdateConfiguration]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByHourly 

New-AzAutomationSchedule
    [-Name] <String>
    [-StartTime] <DateTimeOffset>
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -HourInterval <Byte>
    [-Description <String>]
    [-ExpiryTime <DateTimeOffset>]
    [-TimeZone <String>]
    [-ForUpdateConfiguration]
    [-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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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).

Parameteregenskaper

Typ:Byte
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByDaily
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DayOfWeek

Anger en lista över veckodagar för veckoschemat.

Parameteregenskaper

Typ:

Nullable<T>[DayOfWeek]

Standardvärde:None
Godkända värden:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByMonthlyDayOfWeek
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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

Parameteregenskaper

Typ:DayOfWeekOccurrence
Standardvärde:None
Godkända värden:First, Second, Third, Fourth, Last
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByMonthlyDayOfWeek
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DaysOfMonth

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

Parameteregenskaper

Typ:

DaysOfMonth[]

Standardvärde:None
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
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByMonthlyDaysOfMonth
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DaysOfWeek

Anger en lista över veckodagar för veckoschemat.

Parameteregenskaper

Typ:

DayOfWeek[]

Standardvärde:None
Godkända värden:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByWeekly
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Description

Anger en beskrivning av schemat.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:DateTimeOffset
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByDaily
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ByWeekly
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ByMonthlyDaysOfMonth
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ByMonthlyDayOfWeek
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ByHourly
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ForUpdateConfiguration

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-HourInterval

Anger ett intervall i timmar för schemat.

Parameteregenskaper

Typ:Byte
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByHourly
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MonthInterval

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

Parameteregenskaper

Typ:Byte
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByMonthlyDaysOfMonth
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ByMonthlyDayOfWeek
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Anger ett namn för schemat.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:2
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-OneTime

Anger att cmdleten skapar ett engångsschema.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByOneTime
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ResourceGroupName

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:DateTimeOffset
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:3
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-TimeZone

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WeekInterval

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

Parameteregenskaper

Typ:Byte
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByWeekly
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

DateTimeOffset

SwitchParameter

Utdata

Schedule