Freigeben über

New-AzureRMAutomationSchedule

  • Referenz
Modul:
AzureRM.Automation

Erstellt einen Automatisierungszeitplan.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

New-AzureRMAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -DayInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRMAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfWeek <DayOfWeek[]>]
   [-ExpiryTime <DateTimeOffset>]
   -WeekInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRMAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfMonth <DaysOfMonth[]>]
   [-ExpiryTime <DateTimeOffset>]
   -MonthInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRMAutomationSchedule
   [-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-AzureRMAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-OneTime]
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRMAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -HourInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureRmAutomationSchedule erstellt einen Zeitplan in Azure Automation.

Beispiele

Beispiel 1: Erstellen eines einmaligen Zeitplans in ortszeit

PS C:\> $TimeZone = ([System.TimeZoneInfo]::Local).Id
PS C:\> New-AzureRmAutomationSchedule -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 Terminplans

PS C:\> $StartTime = Get-Date "13:00:00"
PS C:\> $EndTime = $StartTime.AddYears(1)
PS C:\> New-AzureRmAutomationSchedule -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 3: Erstellen eines wöchentlichen Terminplans

PS C:\> $StartTime = (Get-Date "13:00:00").AddDays(1)
PS C:\> [System.DayOfWeek[]]$WeekDays = @([System.DayOfWeek]::Monday..[System.DayOfWeek]::Friday)
PS C:\> New-AzureRmAutomationSchedule -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.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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).

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DayOfWeek

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

Typ:Nullable<T>[DayOfWeek]
Zulässige Werte:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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
Typ:DayOfWeekOccurrence
Zulässige Werte:First, Second, Third, Fourth, Last
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DaysOfMonth

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

Typ:DaysOfMonth[]
Zulässige Werte: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
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DaysOfWeek

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

Typ:DayOfWeek[]
Zulässige Werte:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für den Zeitplan an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ExpiryTime

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

Typ:DateTimeOffset
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForUpdateConfiguration

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-HourInterval

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

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MonthInterval

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

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen für den Zeitplan an.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OneTime

Gibt an, dass das Cmdlet einen einmaligen Zeitplan erstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

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

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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 der Parameter TimeZone angegeben ist, wird der Offset ignoriert, und die angegebene Zeitzone wird verwendet.

Typ:DateTimeOffset
Position:3
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TimeZone

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WeekInterval

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

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

DateTimeOffset

Ausgaben

Schedule