New-AzAutomationSchedule

Модуль:

Az.Automation Module

Создает расписание автоматизации.

Синтаксис

ByDaily (По умолчанию)

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

Описание

Командлет New-AzAutomationSchedule создает расписание в Azure Automation.

Примеры

Пример 1. Создание одноразового расписания в локальном времени

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

Первая команда получает идентификатор часового пояса из системы и сохраняет его в переменной $TimeZone. Вторая команда создает расписание, которое выполняется один раз по текущей дате в 11:00 в указанном часовом поясе.

Пример 2. Создание однократного расписания в другом часовом поясе

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

Первая команда инициализирует переменную $TimeZone со значением , вторая команда создает расписание, которое выполняется один раз по текущей дате в 23:00 UTC в указанном часовом поясе.

Примечание. Расписание начального времени вычисляется путем добавления смещения часового пояса для предоставленного начального времени

Пример 3. Создание повторяющегося расписания

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

Первая команда создает объект date с помощью командлета Get-Date , а затем сохраняет объект в переменной $StartDate. Укажите время, которое составляет не менее пяти минут в будущем. Вторая команда создает объект date с помощью командлета Get-Date , а затем сохраняет объект в переменной $EndDate. Команда задает будущее время. Последняя команда создает ежедневное расписание с именем Schedule02, чтобы начать время, хранящееся в $StartDate, и истекает срок действия в $EndDate.

Пример 4. Создание еженедельного регулярного расписания

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

Первая команда создает объект date с помощью командлета Get-Date , а затем сохраняет объект в переменной $StartDate. Вторая команда создает массив дней недели, содержащих понедельник, вторник, среду, четверг и пятницу. Последняя команда создает ежедневное расписание с именем Schedule03, которое будет работать в понедельник до пятницы каждую неделю в 13:00. Срок действия расписания никогда не истекает.

Параметры

-AutomationAccountName

Указывает имя учетной записи службы автоматизации, для которой этот командлет создает расписание.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	1
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-DayInterval

Задает интервал (в днях) для расписания. Если этот параметр не указан, и параметр OneTime не указан, значение по умолчанию — одно (1).

Свойства параметров

Тип:	Byte
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByDaily

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DayOfWeek

Указывает список дней недели для еженедельного расписания.

Свойства параметров

Тип:	Nullable<T>[DayOfWeek]
Default value:	None
Допустимые значения:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByMonthlyDayOfWeek

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DayOfWeekOccurrence

Указывает вхождение недели в течение месяца, выполняемого расписанием. psdx_paramvalues

• 1
• 2
• 3
• 4
• -1
• First
• Second
• Третья
• Четвёртый
• LastDay

Свойства параметров

Тип:	DayOfWeekOccurrence
Default value:	None
Допустимые значения:	First, Second, Third, Fourth, Last
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByMonthlyDayOfWeek

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DaysOfMonth

Указывает список дней месяца для ежемесячного расписания.

Свойства параметров

Тип:	DaysOfMonth[]
Default value:	None
Допустимые значения:	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
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByMonthlyDaysOfMonth

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DaysOfWeek

Указывает список дней недели для еженедельного расписания.

Свойства параметров

Тип:	DayOfWeek[]
Default value:	None
Допустимые значения:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByWeekly

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Свойства параметров

Тип:	IAzureContextContainer
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Description

Указывает описание расписания.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ExpiryTime

Указывает время истечения срока действия расписания в качестве объекта DateTimeOffset . Можно указать строку, которую можно преобразовать в допустимый DateTimeOffset.

Свойства параметров

Тип:	DateTimeOffset
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByDaily

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByWeekly

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByMonthlyDaysOfMonth

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByMonthlyDayOfWeek

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByHourly

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ForUpdateConfiguration

Указывает, что этот объект расписания будет использоваться для планирования конфигурации обновления программного обеспечения

Свойства параметров

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-HourInterval

Задает интервал (в часах) для расписания.

Свойства параметров

Тип:	Byte
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByHourly

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MonthInterval

Задает интервал (в месяцах) для расписания.

Свойства параметров

Тип:	Byte
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByMonthlyDaysOfMonth

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByMonthlyDayOfWeek

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

Задает имя расписания.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-OneTime

Указывает, что командлет создает однократное расписание.

Свойства параметров

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByOneTime

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ResourceGroupName

Указывает имя группы ресурсов, для которой этот командлет создает расписание.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-StartTime

Указывает время начала расписания в качестве объекта DateTimeOffset . Можно указать строку, которую можно преобразовать в допустимый DateTimeOffset. Если указан часовой пояс , время начала вычисляется путем добавления смещения входного часового пояса.

Свойства параметров

Тип:	DateTimeOffset
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	3
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-TimeZone

Указывает часовой пояс расписания. Эта строка может быть идентификатором IANA или идентификатором часового пояса Windows.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-WeekInterval

Задает интервал (в неделях) для расписания.

Свойства параметров

Тип:	Byte
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByWeekly

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

DateTimeOffset

SwitchParameter

Выходные данные

Schedule

Связанные ссылки

• Get-AzAutomationSchedule
• Remove-AzAutomationSchedule
• Set-AzAutomationSchedule