New-SCOMMaintenanceSchedule

Ссылка

Модуль:: OperationsManager

Создает расписание обслуживания.

Синтаксис

New-SCOMMaintenanceSchedule
   [-Name] <String>
   [-Recursive]
   [-Enabled]
   [-MonitoringObjects] <Guid[]>
   [-ActiveStartTime] <DateTime>
   [[-ActiveEndDate] <DateTime>]
   [-Duration] <Int32>
   [-ReasonCode] <MaintenanceModeReason>
   [[-Comments] <String>]
   [-FreqType] <Int32>
   [[-FreqInterval] <Int32>]
   [[-FreqRecurrenceFactor] <Int32>]
   [[-FreqRelativeInterval] <Int32>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-SCOMMaintenanceSchedule создает расписание обслуживания.

Если ресурс находится в режиме обслуживания, Operations Manager подавляет оповещения, уведомления, правила, мониторы, автоматические ответы, изменения состояния и новые оповещения. Расписание обслуживания можно использовать для планирования набора ресурсов для перехода в режим обслуживания.

Этот командлет можно использовать для создания расписаний, которые выполняются один раз, ежедневно, еженедельно или ежемесячно в определенный день или день недели. Этот командлет вернет GUID созданного расписания.

По умолчанию этот командлет использует активное постоянное подключение к группе управления. Используйте параметр SCSession для указания другого постоянного подключения. Можно создать временное подключение к группе управления с помощью параметров ComputerName и учетных данных. Дополнительные сведения см. в Get-Help about_OpsMgr_Connections.

Примеры

Пример 1. Добавление объекта компьютера Windows в новое расписание обслуживания

PS C:\>$windowsComputer = Get-SCOMClass -DisplayName "Windows Computer" | Get-SCOMClassInstance | Where-Object { $_.DisplayName -eq 'Agent01.contoso.local' }
PS C:\>New-SCOMMaintenanceSchedule -Name 'Test Maintenance Schedule' -MonitoringObjects $windowsComputer.Id -ActiveStartTime $((Get-Date).AddMinutes(2)) -DurationInMinutes 240 -ReasonCode PlannedOther -FreqType 1 -Enabled

Пример добавления объекта компьютера Windows для определенного сервера: Agent01.contoso.com в новое расписание обслуживания в течение 240 минут, выполняя только 1 раз.

Пример 2. Создание расписания ежедневного обслуживания

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is UTC (Coordinated Universal Time)
PS C:\>$startDate = [DateTime]::SpecifyKind([DateTime]"2024-03-30T01:00:00", [System.DateTimeKind]::Utc)
PS C:\>$durationInMinutes = 90
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Daily Maintenance at 1AM" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 4 -FreqInterval 1 -Enabled

Пример настройки ежедневного расписания обслуживания для определенного сервера и связанных объектов мониторинга: Agent01.contoso.local, начиная с 1:00 и продолжительностью в течение 90 минут.

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

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-03-29T02:00:00"
PS C:\>$durationInMinutes = 120
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Weekly Wednesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 8 -FreqInterval 8 -FreqRecurrenceFactor 1 -Enabled

Пример настройки еженедельного расписания обслуживания в среду для определенных серверов и связанных объектов мониторинга: Agent01.contoso.local, начиная с 2:00 и продолжительностью в течение 120 минут.

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

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-04-01T03:00:00"
PS C:\>$durationInMinutes = 180
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Monthly Second Tuesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 32 -FreqInterval 2 -FreqRelativeInterval 2 -FreqRecurrenceFactor 1 -Enabled

Пример создания ежемесячного расписания обслуживания во второй вторник каждого месяца для определенных серверов и связанных объектов мониторинга: Agent01.contoso.local, начиная с 3:00 и продолжительностью в течение 180 минут.

Параметры

-ActiveEndDate

Указывает дату окончания и время окончания, когда расписание должно прекратить выполнение. Если этот параметр не указан, расписание будет продолжать выполняться в течение всего времени (или до тех пор, пока он не будет удален или отключен).

Например, если вы хотите создать расписание, которое должно завершиться 1 мая 2016 г. в 9:00, необходимо указать "01-05-2016 09:00:00" в качестве ActiveEndDate. Вы можете передать строку, указав нужное время в локальном времени. Однако если вы хотите указать время в формате UTC, следует указать объект dateTime DateTime с параметром DateTimeKind, установленным в формате UTC.

Тип:	DateTime
Position:	5
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ActiveStartTime

Указывает дату начала и время, когда расписание должно быть активным. Например, если вы хотите создать расписание, которое должно начинаться с 1 мая 2016 года и должно выполняться в 9:00, необходимо указать "01-05-2016 09:00:00", как ActiveStartTime. Вы можете передать строку, указав нужное время в локальном времени. Однако если вы хотите указать время в формате UTC, необходимо указать объект DateTime с параметром DateTimeKind, заданным в формате UTC.

Тип:	DateTime
Position:	4
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Comments

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

Тип:	String
Position:	8
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ComputerName

Задает массив имен компьютеров. Командлет устанавливает временные подключения с группами управления для этих компьютеров. Вы можете использовать имена NetBIOS, IP-адреса или полные доменные имена (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).

Служба доступа к данным System Center должна быть активной на компьютере. Если компьютер не указан, командлет использует компьютер для текущего подключения группы управления.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

Указывает объект PSCredential для подключения группы управления. Чтобы получить объект PSCredential, используйте командлет Get-Credential. Дополнительные сведения см. в Get-Help Get-Credential. Если указать компьютер в параметре ComputerName, используйте учетную запись, доступ к которому имеется. По умолчанию используется текущий пользователь.

Тип:	PSCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Duration

Указывает длительность расписания обслуживания. Длительность расписания обслуживания — это время, для которого будет длиться расписание обслуживания.

Тип:	Int32
Aliases:	DurationInMinutes
Position:	6
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Enabled

Указывает, будет ли расписание включено или отключено при создании. Если задано значение false, будет создано расписание, но оно будет отключено.

Тип:	SwitchParameter
Position:	2
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FreqInterval

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

1 (один раз). Интервал частоты не используется.
4 (ежедневно). Каждые дни интервала частоты.
8 (еженедельно). Параметр FreqInterval является одним или несколькими из следующих (в сочетании с логическим оператором OR):
- 1 - воскресенье
- 2 - понедельник
- 4 - вторник
- 8 - среда
- 16 - четверг
- 32 - пятница
- 64 - суббота
16 (ежемесячно). В день интервала частоты месяца.
- 1 - воскресенье
- 2 - понедельник
- 3 - вторник
- 4 - среда
- 5 - четверг
- 6 - пятница
- 7 - суббота
32 (ежемесячный относительный). Параметр FreqInterval является одним из следующих значений:
- 8 - День
- 9 - Будний день
- 10 - Выходные дни

Тип:	Int32
Position:	10
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FreqRecurrenceFactor

Количество недель или месяцев между запланированным выполнением задания. FreqRecurrenceFactor используется только в том случае, если параметр FreqType имеет значение 8, 16 или 32. Параметр FreqRecurrenceFactor является целым числом с значением по умолчанию 0.

Тип:	Int32
Position:	11
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FreqRelativeInterval

День выполнения задания. Это обязательно, если расписание отличается от OnceRecurrence расписания. Значение зависит от значения FreqType.

Этот параметр может быть одним из следующих значений:

1 (первое)
2 (вторая)
4 (третий)
8 (четвертый)
16 (последнее)

Тип:	Int32
Position:	12
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FreqType

Указывает, когда задание должно выполняться. Допустимые значения для этого параметра:

1 (один раз)
4 (ежедневно)
8 (еженедельно)
16 (ежемесячно)
32 (ежемесячно, относительно параметра FreqInterval)

Тип:	Int32
Position:	9
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MonitoringObjects

Задает массив объектов мониторинга GUIDS, которые будут помещены в режим обслуживания. Чтобы указать объект мониторинга, который созданный график будет помещен в режим обслуживания, необходимо передать атрибут идентификатора объекта мониторинга.

Для расписания можно указать один или несколько объектов мониторинга. Однако невозможно создать расписание без какого-либо объекта мониторинга.

Тип:	Guid[]
Position:	3
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

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

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ReasonCode

Указывает код причины для расписания обслуживания, указывающего причину периода обслуживания.

Допустимые значения для этого параметра:

PlannedOther
Незапланированное непланированное
PlannedHardwareMaintenance
Незапланированная программаHardwareMaintenance
PlannedHardwareInstallation
Внеплановая установкаHardwareInstallation
PlannedOperatingSystemReconfiguration
UnplannedOperatingSystemReconfiguration
PlannedApplicationMaintenance
UnplannedApplicationMaintenance
ApplicationInstallation
ApplicationUnresponsive
ApplicationUnstable
SecurityIssue
LossOfNetworkConnectivity

Тип:	MaintenanceModeReason
Допустимые значения:	PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:	7
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Recursive

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

Тип:	SwitchParameter
Position:	1
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SCSession

Задает массив объектов подключения .

Тип:	Connection[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Поделиться через

New-SCOMMaintenanceSchedule

Синтаксис

Описание

Примеры

Пример 1. Добавление объекта компьютера Windows в новое расписание обслуживания

Пример 2. Создание расписания ежедневного обслуживания

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

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

Параметры

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

Дополнительные ресурсы

Поделиться через

New-SCOMMaintenanceSchedule

Синтаксис

Описание

Примеры

Пример 1. Добавление объекта компьютера Windows в новое расписание обслуживания

Пример 2. Создание расписания ежедневного обслуживания

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

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

Параметры

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

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

Дополнительные ресурсы