Udostępnij za pośrednictwem


New-AzAutomationSchedule

Tworzy harmonogram automatyzacji.

Składnia

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

Opis

Polecenie cmdlet New-AzAutomationSchedule tworzy harmonogram w usłudze Azure Automation.

Przykłady

Przykład 1. Tworzenie jednorazowego harmonogramu w czasie lokalnym

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

Pierwsze polecenie pobiera identyfikator strefy czasowej z systemu i zapisuje go w zmiennej $TimeZone. Drugie polecenie tworzy harmonogram, który jest uruchamiany jednorazowo w bieżącej dacie o godzinie 11:00 w określonej strefie czasowej.

Przykład 2. Tworzenie jednorazowego harmonogramu w innej strefie czasowej

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

Pierwsze polecenie inicjuje zmienną $TimeZone z wartością Europe/Paris Drugie polecenie tworzy harmonogram, który jest uruchamiany jeden raz w bieżącej dacie o godzinie 23:00 UTC w określonej strefie czasowej.

Uwaga: obliczana jest Godzina rozpoczęcia przez dodanie przesunięcia strefy czasowej do podanego godzina rozpoczęcia

Przykład 3. Tworzenie harmonogramu cyklicznego

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

Pierwsze polecenie tworzy obiekt daty przy użyciu polecenia cmdlet get-date , a następnie zapisuje obiekt w zmiennej $StartDate. Określ czas, który w przyszłości wynosi co najmniej pięć minut. Drugie polecenie tworzy obiekt daty przy użyciu polecenia cmdlet get-date , a następnie zapisuje obiekt w zmiennej $EndDate. Polecenie określa czas w przyszłości. Końcowe polecenie tworzy dzienny harmonogram o nazwie Schedule02, aby rozpocząć w czasie przechowywanym w $StartDate i wygasać w czasie przechowywanym w $EndDate.

Przykład 4. Tworzenie cotygodniowego harmonogramu cyklicznego

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

Pierwsze polecenie tworzy obiekt daty przy użyciu polecenia cmdlet get-date , a następnie zapisuje obiekt w zmiennej $StartDate. Drugie polecenie tworzy tablicę dni tygodnia, która zawiera poniedziałek, wtorek, środę, czwartek i piątek. Ostatnie polecenie tworzy dzienny harmonogram o nazwie Schedule03, który będzie uruchamiany w poniedziałek do piątku każdego tygodnia o godzinie 13:00. Harmonogram nigdy nie wygaśnie.

Parametry

-AutomationAccountName

Określa nazwę konta usługi Automation, dla którego to polecenie cmdlet tworzy harmonogram.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DayInterval

Określa interwał w dniach dla harmonogramu. Jeśli nie określisz tego parametru i nie określisz parametru OneTime, wartość domyślna to jeden (1).

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DayOfWeek

Określa listę dni tygodnia dla harmonogramu tygodniowego.

Typ:Nullable<T>[DayOfWeek]
Dopuszczalne wartości:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DayOfWeekOccurrence

Określa wystąpienie tygodnia w ciągu miesiąca, w ramach którego jest uruchamiany harmonogram. psdx_paramvalues

  • 1
  • 2
  • 3
  • 4
  • -1
  • Pierwszy
  • Sekunda
  • Trzeci
  • Czwarty
  • LastDay
Typ:DayOfWeekOccurrence
Dopuszczalne wartości:First, Second, Third, Fourth, Last
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DaysOfMonth

Określa listę dni miesiąca dla harmonogramu miesięcznego.

Typ:DaysOfMonth[]
Dopuszczalne wartości: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
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DaysOfWeek

Określa listę dni tygodnia dla harmonogramu tygodniowego.

Typ:DayOfWeek[]
Dopuszczalne wartości:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Description

Określa opis harmonogramu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ExpiryTime

Określa czas wygaśnięcia harmonogramu jako obiekt DateTimeOffset. Można określić ciąg, który można przekonwertować na prawidłowy DateTimeOffset.

Typ:DateTimeOffset
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ForUpdateConfiguration

Wskazuje, że ten obiekt harmonogramu będzie używany do planowania konfiguracji aktualizacji oprogramowania

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-HourInterval

Określa interwał w godzinach dla harmonogramu.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MonthInterval

Określa interwał w miesiącach dla harmonogramu.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę harmonogramu.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-OneTime

Określa, że polecenie cmdlet tworzy harmonogram jednorazowy.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów, dla której to polecenie cmdlet tworzy harmonogram.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StartTime

Określa godzinę rozpoczęcia harmonogramu jako obiekt DateTimeOffset. Można określić ciąg, który można przekonwertować na prawidłowy DateTimeOffset. Jeśli zostanie podana timezone, godzina rozpoczęcia jest obliczana przez dodanie przesunięcia wartości wejściowej timezone.

Typ:DateTimeOffset
Position:3
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-TimeZone

Określa strefę czasową harmonogramu. Ten ciąg może być identyfikatorem IANA lub identyfikatorem strefy czasowej systemu Windows.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WeekInterval

Określa interwał w tygodniach dla harmonogramu.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

DateTimeOffset

SwitchParameter

Dane wyjściowe

Schedule