New-AzAutomationSchedule

Referenz

Modul:: Az.Automation

Erstellt einen Automatisierungsplan.

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

Beschreibung

Das Cmdlet "New-AzAutomationSchedule" erstellt einen Zeitplan in Azure Automation.

Beispiele

Beispiel 1: Erstellen eines einmaligen Zeitplans in der lokalen Zeit

$TimeZone = ([System.TimeZoneInfo]::Local).Id
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone

Der erste Befehl ruft die Zeitzonen-ID aus dem System ab und speichert sie in der $TimeZone Variable. Der zweite Befehl erstellt einen Zeitplan, der einmal am aktuellen Datum am 11:00 Uhr in der angegebenen Zeitzone ausgeführt wird.

Beispiel 2: Erstellen eines einmaligen Zeitplans in einer anderen Zeitzone

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

Der erste Befehl initialisiert eine $TimeZone Variable mit Wert Europe/Paris Der zweite Befehl erstellt einen Zeitplan, der am aktuellen Datum am 23:00 UTC in der angegebenen Zeitzone ausgeführt wird.

Hinweis: Planen von StartTime wird berechnet, indem der TimeZone Offset hinzugefügt wird, um StartTime bereitgestellt zu werden.

Beispiel 3: Erstellen eines Wiederkehrenden Zeitplans

$StartTime = Get-Date "13:00:00"
$EndTime = $StartTime.AddYears(1)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DayInterval 1 -ResourceGroupName "ResourceGroup01"

Der erste Befehl erstellt ein Datumsobjekt mithilfe des Cmdlets "Get-Date ", und speichert dann das Objekt in der $StartDate-Variable. Geben Sie eine Uhrzeit an, die mindestens fünf Minuten in Zukunft beträgt. Der zweite Befehl erstellt ein Datumsobjekt mithilfe des Cmdlets "Get-Date ", und speichert dann das Objekt in der $EndDate Variablen. Mit dem Befehl wird ein Zeitpunkt angegeben, der in der Zukunft liegt. Der letzte Befehl erstellt einen täglichen Zeitplan mit dem Namen "Schedule02", der zu dem Zeitpunkt beginnt, der in $StartDate gespeichert ist und zum Zeitpunkt abläuft, der in $EndDate gespeichert ist.

Beispiel 4: Erstellen eines wöchentlichen Wiederkehrenden Zeitplans

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

Der erste Befehl erstellt ein Datumsobjekt mithilfe des Cmdlets "Get-Date ", und speichert dann das Objekt in der $StartDate-Variable. Der zweite Befehl erstellt ein Array von Wochentagen, die Montag, Dienstag, Mittwoch, Donnerstag und Freitag enthalten. Der endgültige Befehl erstellt einen täglichen Zeitplan namens "Schedule03", der montags bis freitags jede Woche um 13:00 Uhr ausgeführt wird. Der Zeitplan läuft nie ab.

Parameter

-AutomationAccountName

Gibt den Namen eines Automatisierungskontos an, für das dieses Cmdlet einen Zeitplan erstellt.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DayInterval

Gibt ein Intervall in Tagen für den Zeitplan an. Wenn Sie diesen Parameter nicht angeben, und Sie geben den OneTime-Parameter nicht an, ist der Standardwert eine (1).

Type:	Byte
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DayOfWeek

Gibt eine Liste der Tage der Woche für den wöchentlichen Zeitplan an.

Type:	Nullable<T>[DayOfWeek]
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DayOfWeekOccurrence

Gibt das Vorkommen der Woche innerhalb des Monats an, in dem der Zeitplan ausgeführt wird. psdx_paramvalues

1
2
3
4
-1
First
Second
Third
Vierter
LastDay

Type:	DayOfWeekOccurrence
Accepted values:	First, Second, Third, Fourth, Last
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysOfMonth

Gibt eine Liste der Tage des Monats für den monatlichen Zeitplan an.

Type:	DaysOfMonth[]
Accepted values:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysOfWeek

Gibt eine Liste der Tage der Woche für den wöchentlichen Zeitplan an.

Type:	DayOfWeek[]
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnement, die für die Kommunikation mit Azure verwendet werden

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Gibt eine Beschreibung für den Zeitplan an.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ExpiryTime

Gibt die Ablaufzeit eines Zeitplans als DateTimeOffset-Objekt an. Sie können eine Zeichenfolge angeben, die in ein gültiges DateTimeOffset konvertiert werden kann.

Type:	DateTimeOffset
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForUpdateConfiguration

Gibt an, dass dieses Zeitplanobjekt zum Planen einer Softwareupdatekonfiguration verwendet wird.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-HourInterval

Gibt ein Intervall in Stunden für den Zeitplan an.

Type:	Byte
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthInterval

Gibt ein Intervall in Monaten für den Zeitplan an.

Type:	Byte
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Gibt einen Namen für den Zeitplan an.

Type:	String
Position:	2
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OneTime

Gibt an, dass das Cmdlet einen einmaligen Zeitplan erstellt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Gibt den Namen einer Ressourcengruppe an, für die dieses Cmdlet einen Zeitplan erstellt.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-StartTime

Gibt die Startzeit eines Zeitplans als DateTimeOffset-Objekt an. Sie können eine Zeichenfolge angeben, die in ein gültiges DateTimeOffset konvertiert werden kann. Wenn die TimeZone bereitgestellt wird, wird StartTime durch Hinzufügen des Offsets von Input TimeZone berechnet.

Type:	DateTimeOffset
Position:	3
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-TimeZone

Gibt die Zeitzone für den Zeitplan an. Diese Zeichenfolge kann die IANA-ID oder die Windows-Zeitzonen-ID sein.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WeekInterval

Gibt ein Intervall in Wochen für den Zeitplan an.

Type:	Byte
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

String

DateTimeOffset

SwitchParameter

Ausgaben

Schedule