New-AzAutomationSchedule
Crea una pianificazione di Automazione.
Sintassi
ByDaily (Impostazione predefinita)
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>]
Descrizione
Il cmdlet New-AzAutomationSchedule crea una pianificazione in Automazione di Azure.
Esempio
Esempio 1: Creare una pianificazione una tantum nell'ora locale
$TimeZone = ([System.TimeZoneInfo]::Local).Id
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone
Il primo comando ottiene l'ID del fuso orario dal sistema e lo archivia nella variabile $TimeZone.
Il secondo comando crea una pianificazione che viene eseguita una sola volta nella data corrente alle 11:00 pm nel fuso orario specificato.
Esempio 2: Creare una pianificazione una tantum in un altro fuso orario
$TimeZone = "Europe/Paris"
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00Z" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone
Il primo comando inizializza una variabile $TimeZone con valore Europe/Paris Il secondo comando crea una pianificazione che viene eseguita una sola volta nella data corrente alle 23.00 UTC nel fuso orario specificato.
Nota: la pianificazione di StartTime viene calcolata aggiungendo l'offset timezone a startTime specificato
Esempio 3: Creare una pianificazione ricorrente
$StartTime = Get-Date "13:00:00"
$EndTime = $StartTime.AddYears(1)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DayInterval 1 -ResourceGroupName "ResourceGroup01"
Il primo comando crea un oggetto data usando il cmdlet Get-Date e quindi archivia l'oggetto nella variabile $StartDate.
Specificare un'ora di almeno cinque minuti in futuro.
Il secondo comando crea un oggetto data usando il cmdlet Get-Date e quindi archivia l'oggetto nella variabile $EndDate.
Il comando specifica un'ora futura.
Il comando finale crea una pianificazione giornaliera denominata Schedule02 per iniziare al momento archiviato in $StartDate e scadere al momento archiviato in $EndDate.
Esempio 4: Creare una pianificazione periodica settimanale
$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"
Il primo comando crea un oggetto data usando il cmdlet Get-Date e quindi archivia l'oggetto nella variabile $StartDate.
Il secondo comando crea una matrice di giorni della settimana che contiene lunedì, martedì, mercoledì, giovedì e venerdì.
Il comando finale crea una pianificazione giornaliera denominata Schedule03 che verrà eseguita da lunedì a venerdì ogni settimana alle 13:00. La pianificazione non scadrà mai.
Parametri
-AutomationAccountName
Specifica il nome di un account di Automazione per il quale questo cmdlet crea una pianificazione.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: 1 Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-DayInterval
Specifica un intervallo, espresso in giorni, per la pianificazione.
Se non si specifica questo parametro e non si specifica il parametro OneTime , il valore predefinito è uno (1).
Proprietà dei parametri
Tipo: Byte
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByDaily
Posizione: Named Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-DayOfWeek
Specifica un elenco di giorni della settimana per la pianificazione settimanale.
Proprietà dei parametri
Tipo: Nullable<T> [ DayOfWeek ]
Valore predefinito: None Valori accettati: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByMonthlyDayOfWeek
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-DayOfWeekOccurrence
Specifica l'occorrenza della settimana entro il mese in cui viene eseguita la pianificazione.
psdx_paramvalues
1
2
3
4
-1
First
Secondo
Terza
Quarta
LastDay
Proprietà dei parametri
Tipo: DayOfWeekOccurrence
Valore predefinito: None Valori accettati: First, Second, Third, Fourth, Last Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByMonthlyDayOfWeek
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-DaysOfMonth
Specifica un elenco di giorni del mese per la pianificazione mensile.
Proprietà dei parametri
Tipo: DaysOfMonth [ ]
Valore predefinito: None Valori accettati: 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 Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByMonthlyDaysOfMonth
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-DaysOfWeek
Specifica un elenco di giorni della settimana per la pianificazione settimanale.
Proprietà dei parametri
Tipo: DayOfWeek [ ]
Valore predefinito: None Valori accettati: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByWeekly
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure
Proprietà dei parametri
Tipo: IAzureContextContainer
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-Description
Specifica una descrizione per la pianificazione.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-ExpiryTime
Specifica l'ora di scadenza di una pianificazione come oggetto DateTimeOffset .
È possibile specificare una stringa che può essere convertita in un valore DateTimeOffset valido.
Proprietà dei parametri
Tipo: DateTimeOffset
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByDaily
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
ByWeekly
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
ByMonthlyDaysOfMonth
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
ByMonthlyDayOfWeek
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
ByHourly
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-ForUpdateConfiguration
Indica che questo oggetto pianificazione verrà utilizzato per la pianificazione di una configurazione di aggiornamento software
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-HourInterval
Specifica un intervallo, espresso in ore, per la pianificazione.
Proprietà dei parametri
Tipo: Byte
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByHourly
Posizione: Named Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-MonthInterval
Specifica un intervallo, in Mesi, per la pianificazione.
Proprietà dei parametri
Tipo: Byte
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByMonthlyDaysOfMonth
Posizione: Named Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
ByMonthlyDayOfWeek
Posizione: Named Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-Name
Specifica un nome per la pianificazione.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: 2 Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-OneTime
Specifica che il cmdlet crea una pianificazione una tantum.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByOneTime
Posizione: Named Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
-ResourceGroupName
Specifica il nome di un gruppo di risorse per il quale questo cmdlet crea una pianificazione.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: 0 Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-StartTime
Specifica l'ora di inizio di una pianificazione come oggetto DateTimeOffset .
È possibile specificare una stringa che può essere convertita in un valore DateTimeOffset valido.
Se viene specificato timezone , StartTime viene calcolato aggiungendo l'offset del fuso orario di input.
Proprietà dei parametri
Tipo: DateTimeOffset
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: 3 Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-TimeZone
Specifica il fuso orario per la pianificazione.
Questa stringa può essere l'ID IANA o l'ID fuso orario di Windows.
Proprietà dei parametri
Tipo: String
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
(All)
Posizione: Named Obbligatorio: False Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: True Valore dagli argomenti rimanenti: False
-WeekInterval
Specifica un intervallo, espresso in settimane, per la pianificazione.
Proprietà dei parametri
Tipo: Byte
Valore predefinito: None Supporta i caratteri jolly: False DontShow: False
Set di parametri
ByWeekly
Posizione: Named Obbligatorio: True Valore dalla pipeline: False Valore dalla pipeline in base al nome della proprietà: False Valore dagli argomenti rimanenti: False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters .
Output
