New-AzAutomationSchedule

  • Referenz
Modul:
Az.Automation

Erstellt einen Automatisierungszeitplan.

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 ortszeit

$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 Variablen. Der zweite Befehl erstellt einen Zeitplan, der einmal am aktuellen Datum um 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 dem Wert Europe/Paris Der zweite Befehl erstellt einen Zeitplan, der einmal am aktuellen Datum um 23:00 UTC in der angegebenen Zeitzone ausgeführt wird.

Hinweis: "StartTime planen" wird berechnet, indem der TimeZone-Offset zu "StartTime" hinzugefügt wird.

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 das Objekt dann in der $StartDate Variablen. Geben Sie eine Zeit an, die mindestens fünf Minuten in der Zukunft liegt. Der zweite Befehl erstellt ein Datumsobjekt mithilfe des Cmdlets "Get-Date ", und speichert das Objekt dann in der variablen $EndDate. Mit dem Befehl wird ein Zeitpunkt angegeben, der in der Zukunft liegt. Der letzte Befehl erstellt einen täglichen Zeitplan namens "Schedule02", der zu dem in $StartDate gespeicherten Zeitpunkt beginnt und zum in $EndDate gespeicherten Zeitpunkt abläuft.

Beispiel 4: Erstellen eines wöchentlichen Terminplans

$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 das Objekt dann in der $StartDate Variablen. Mit dem zweiten Befehl wird ein Array von Wochentagen erstellt, das Montag, Dienstag, Mittwoch, Donnerstag und Freitag enthält. Der letzte 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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DayInterval

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

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

-DayOfWeek

Gibt eine Liste der Tage der Woche für den Wochenplan an.

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

-DayOfWeekOccurrence

Gibt das Vorkommen der Woche innerhalb des Monats an, den der Zeitplan ausführt. psdx_paramvalues

  • 1
  • 2
  • 3
  • 4
  • -1
  • Vorname
  • Second
  • Third
  • Viertes
  • LastDay
Type:DayOfWeekOccurrence
Accepted values:First, Second, Third, Fourth, Last
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DaysOfWeek

Gibt eine Liste der Tage der Woche für den Wochenplan an.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-Description

Gibt eine Beschreibung für den Zeitplan an.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForUpdateConfiguration

Gibt an, dass dieses Zeitplanobjekt für die Planung einer Softwareupdatekonfiguration verwendet wird.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MonthInterval

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

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

-Name

Gibt einen Namen für den Zeitplan an.

Type:String
Position:2
Default value:None
Required:True
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
Required:True
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
Required:True
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 angegeben wird, wird StartTime berechnet, indem der Offset der Eingabezeitzone hinzugefügt wird.

Type:DateTimeOffset
Position:3
Default value:None
Required:True
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WeekInterval

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

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

Eingaben

String

DateTimeOffset

SwitchParameter

Ausgaben

Schedule