New-AzAutomationSchedule

Modulo:

Az.Automation

Crea una pianificazione di Automazione.

Sintassi

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>]

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 orario futuro. 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.

Tipo:	String
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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).

Tipo:	Byte
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DayOfWeek

Specifica un elenco di giorni della settimana per la pianificazione settimanale.

Tipo:	Nullable<T>[DayOfWeek]
Valori accettati:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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

Tipo:	DayOfWeekOccurrence
Valori accettati:	First, Second, Third, Fourth, Last
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DaysOfMonth

Specifica un elenco di giorni del mese per la pianificazione mensile.

Tipo:	DaysOfMonth[]
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
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DaysOfWeek

Specifica un elenco di giorni della settimana per la pianificazione settimanale.

Tipo:	DayOfWeek[]
Valori accettati:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Description

Specifica una descrizione per la pianificazione.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	DateTimeOffset
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ForUpdateConfiguration

Indica che questo oggetto pianificazione verrà utilizzato per la pianificazione di una configurazione di aggiornamento software

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-HourInterval

Specifica un intervallo, espresso in ore, per la pianificazione.

Tipo:	Byte
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MonthInterval

Specifica un intervallo, in Mesi, per la pianificazione.

Tipo:	Byte
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Name

Specifica un nome per la pianificazione.

Tipo:	String
Posizione:	2
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-OneTime

Specifica che il cmdlet crea una pianificazione una tantum.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ResourceGroupName

Specifica il nome di un gruppo di risorse per il quale questo cmdlet crea una pianificazione.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	DateTimeOffset
Posizione:	3
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-TimeZone

Specifica il fuso orario per la pianificazione. Questa stringa può essere l'ID IANA o l'ID fuso orario di Windows.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-WeekInterval

Specifica un intervallo, espresso in settimane, per la pianificazione.

Tipo:	Byte
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

String

DateTimeOffset

SwitchParameter

Output

Schedule

Collegamenti correlati

• Get-AzAutomationSchedule
• Remove-AzAutomationSchedule
• Set-AzAutomationSchedule