Udostępnij przez

New-AzAutomationSchedule

Moduł:
Az.Automation Module

Tworzy harmonogram automatyzacji.

Składnia

ByDaily (Domyślne) 

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

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 uruchamiany jeden raz w bieżącej dacie o 23:00 UTC w określonej strefie czasowej.

Uwaga: Zaplanowany czas rozpoczęcia jest obliczany przez dodanie przesunięcia strefy czasowej do podanego czasu 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 przechowuje 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 przechowuje 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 przechowuje 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.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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).

Właściwości parametrów

Typ:Byte
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByDaily
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DayOfWeek

Określa listę dni tygodnia dla harmonogramu tygodniowego.

Właściwości parametrów

Typ:

Nullable<T>[DayOfWeek]

Wartość domyślna:None
Akceptowane wartości:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByMonthlyDayOfWeek
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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
  • First
  • Sekunda
  • Third
  • Fourth
  • LastDay

Właściwości parametrów

Typ:DayOfWeekOccurrence
Wartość domyślna:None
Akceptowane wartości:First, Second, Third, Fourth, Last
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByMonthlyDayOfWeek
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DaysOfMonth

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

Właściwości parametrów

Typ:

DaysOfMonth[]

Wartość domyślna:None
Akceptowane 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
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByMonthlyDaysOfMonth
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DaysOfWeek

Określa listę dni tygodnia dla harmonogramu tygodniowego.

Właściwości parametrów

Typ:

DayOfWeek[]

Wartość domyślna:None
Akceptowane wartości:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByWeekly
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Description

Określa opis harmonogramu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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 element DateTimeOffset.

Właściwości parametrów

Typ:DateTimeOffset
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByDaily
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ByWeekly
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ByMonthlyDaysOfMonth
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ByMonthlyDayOfWeek
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ByHourly
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ForUpdateConfiguration

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-HourInterval

Określa interwał w godzinach dla harmonogramu.

Właściwości parametrów

Typ:Byte
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByHourly
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-MonthInterval

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

Właściwości parametrów

Typ:Byte
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByMonthlyDaysOfMonth
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ByMonthlyDayOfWeek
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Name

Określa nazwę harmonogramu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:2
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-OneTime

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByOneTime
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ResourceGroupName

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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 element DateTimeOffset. Jeśli zostanie podana strefa czasowa , godzina rozpoczęcia jest obliczana przez dodanie przesunięcia wejściowej strefy czasowej.

Właściwości parametrów

Typ:DateTimeOffset
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:3
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-TimeZone

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-WeekInterval

Określa interwał w tygodniach dla harmonogramu.

Właściwości parametrów

Typ:Byte
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByWeekly
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

String

DateTimeOffset

SwitchParameter

Wyjść

Schedule