Freigeben über

New-AzAutomationSchedule

Modul:
Az.Automation Module

Erstellt einen Automatisierungszeitplan.

Syntax

ByDaily (Standard) 

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

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 $EndDate Variablen. Der Befehl gibt eine zukünftige Zeit an. 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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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).

Parametereigenschaften

Typ:Byte
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByDaily
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DayOfWeek

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

Parametereigenschaften

Typ:

Nullable<T>[DayOfWeek]

Standardwert:None
Zulässige Werte:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByMonthlyDayOfWeek
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DayOfWeekOccurrence

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

  • 1
  • 2
  • 3
  • 4
  • -1
  • First (Erster)
  • Second
  • Third
  • Viertes
  • LastDay

Parametereigenschaften

Typ:DayOfWeekOccurrence
Standardwert:None
Zulässige Werte:First, Second, Third, Fourth, Last
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByMonthlyDayOfWeek
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DaysOfMonth

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

Parametereigenschaften

Typ:

DaysOfMonth[]

Standardwert:None
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
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByMonthlyDaysOfMonth
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DaysOfWeek

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

Parametereigenschaften

Typ:

DayOfWeek[]

Standardwert:None
Zulässige Werte:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByWeekly
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Gibt eine Beschreibung für den Zeitplan an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:DateTimeOffset
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByDaily
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByWeekly
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByMonthlyDaysOfMonth
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByMonthlyDayOfWeek
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByHourly
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ForUpdateConfiguration

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-HourInterval

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

Parametereigenschaften

Typ:Byte
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByHourly
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MonthInterval

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

Parametereigenschaften

Typ:Byte
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByMonthlyDaysOfMonth
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
ByMonthlyDayOfWeek
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt einen Namen für den Zeitplan an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-OneTime

Gibt an, dass das Cmdlet einen einmaligen Zeitplan erstellt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByOneTime
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:DateTimeOffset
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-TimeZone

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WeekInterval

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

Parametereigenschaften

Typ:Byte
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByWeekly
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

DateTimeOffset

SwitchParameter

Ausgaben

Schedule