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 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.
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
- 100
- -1
- First
- Second
- 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 element 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 element DateTimeOffset. Jeśli zostanie podana strefa czasowa , godzina rozpoczęcia jest obliczana przez dodanie przesunięcia wejściowej strefy czasowej.
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 |