Add-SCOMNotificationSubscription
Добавляет подписку на уведомление.
Синтаксис
Default (по умолчанию)
Add-SCOMNotificationSubscription
[-Name] <String>
[-DisplayName <String>]
[-Description <String>]
[[-Criteria] <String>]
[-OnlyOnResolutionChange]
[-PollingInterval <TimeSpan>]
[-Delay <TimeSpan>]
-Subscriber <NotificationRecipient[]>
[-CcSubscriber <NotificationRecipient[]>]
[-BccSubscriber <NotificationRecipient[]>]
-Channel <Object[]>
[-Disabled]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет add-SCOMNotificationSubscription добавляет подписку на уведомление в System Center — Operations Manager.
В этом выпуске нет поддержки командлетов для подписок области на основе критериев, но вы можете достичь этого результата с помощью Windows PowerShell, напрямую доступ к пакету SDK SCOM.
Примеры
Пример 1. Добавление подписки на уведомление
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> Add-SCOMNotificationSubscription -Name "NewSubscription1" -Subscriber $Subscriber -Channel $Channel
В этом примере добавляется новая подписка на уведомления для всех оповещений.
Первая команда использует командлет get-SCOMNotificationSubscriber для получения подписчиков и хранения результата в переменной $Subscriber.
Вторая команда использует командлет get-SCOMNotificationChannel для получения канала уведомлений и сохраняет результат в переменной $Channel.
Третья команда использует командлет add-SCOMNotificationSubscription с параметрами Name, подписчикаи Channel.
Пример 2. Добавление подписки на уведомление с условиями
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> Add-SCOMNotificationSubscription -Name "NewSubscription2" -Subscriber $Subscriber -Channel $Channel -Delay "1:00:00" -Disabled
В этом примере добавляется новая подписка на уведомления для всех оповещений, но только уведомляет о том, остаются ли условия неизменными в течение 1 часа. В примере создается подписка в отключенном состоянии.
Первая команда использует командлет get-SCOMNotificationSubscriber для получения подписчиков и хранения результата в переменной $Subscriber.
Вторая команда использует командлет get-SCOMNotificationChannel для получения канала уведомлений и сохраняет результат в переменной $Channel.
Третья команда использует командлет add-SCOMNotificationSubscription с параметрами Name, подписчикаи Channel.
Пример 3. Добавление новой подписки для экземпляров определенного класса
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> $Subscription = Add-SCOMNotificationSubscription -Name "NewSubscription3" -Subscriber $Subscriber -Channel $Channel
PS C:\> $HealthService = Get-SCOMClass -Name "Microsoft.SystemCenter.HealthService"
PS C:\> $Subscription.Configuration.MonitoringClassIds.Add( $HealthService.Id )
PS C:\> $Subscription.Update()
В этом примере добавляется новая подписка на уведомления для всех оповещений, а затем используется пакет SDK Operations Manager для области подписки на оповещения, создаваемые экземплярами класса HealthService.
Первая команда использует командлет get-SCOMNotificationSubscriber для получения подписчиков и хранения результата в переменной $Subscriber.
Вторая команда использует командлет get-SCOMNotificationChannel для получения канала уведомлений и сохраняет результат в переменной $Channel.
Третья команда использует командлет add-SCOMNotificationSubscription с параметрами Name, подписчикаи Channel. Командлет сохраняет результат в переменной $Subscription.
Четвертая команда использует командлет Get-SCOMClass и сохраняет результат в переменной $HealthService.
Пятая команда использует метод Add с идентификатором переменной $HealthService.
Шестая команда использует метод Update.
Пример 4. Добавление подписки на уведомление с помощью пакета SDK
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> $Subscription = Add-SCOMNotificationSubscription -Name "NewSubscription4" -Subscriber $Subscriber -Channel $Channel
PS C:\> $WindowsComputers = Get-SCOMGroup -DisplayName "All Windows Computers"
PS C:\> $Subscription.Configuration.MonitoringObjectGroupIds.Add( $WindowsComputers.Id )
PS C:\> $Subscription.Update()
В этом примере добавляется новая подписка на уведомления для всех оповещений, а затем используется пакет SDK Operations Manager для области подписки на оповещения, создаваемые экземплярами в группе "Все компьютеры Windows".
Первая команда использует командлет get-SCOMNotificationSubscriber для получения подписчиков и хранения результата в переменной $Subscriber.
Вторая команда использует командлет get-SCOMNotificationChannel для получения канала уведомлений и сохраняет результат в переменной $Channel.
Третья команда использует командлет add-SCOMNotificationSubscription с параметрами Name, подписчикаи Channel. Командлет сохраняет результат в переменной $Subscription.
Четвертая команда использует командлет Get-SCOMGroup для получения группы "Все компьютеры Windows" и сохраняет результат в переменной $WindowsComputers.
Пятая команда использует метод Add с идентификатором переменной $WindowsComputers.
Шестая команда использует метод Update.
Пример 5. Добавление подписки на уведомление для определенного монитора
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> $Monitor = Get-SCOMMonitor -DisplayName "ContosoMonitor"
PS C:\> $Criteria = @"
>><And xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
>><Expression>
>><SimpleExpression>
>><ValueExpression>
>><Property>ProblemId</Property>
>></ValueExpression>
>><Operator>Equal</Operator>
>><ValueExpression>
>><Value>$($monitor.Id)</Value>
>></ValueExpression>
>></SimpleExpression>
>></Expression>
>><Expression>
>><SimpleExpression>
>><ValueExpression>
>><Property>Severity</Property>
>></ValueExpression>
>><Operator>Equal</Operator>
>><ValueExpression>
>><Value>2</Value>
>></ValueExpression>
>></SimpleExpression>
>></Expression>
>>"@
PS C:\> Add-SCOMNotificationSubscription -Name "Subscription03" -Subscriber $Subscriber -Channel $Channel -Criteria $Criteria
В этом примере добавляется новая подписка на уведомления для всех критически важных оповещений, создаваемых монитором с отображаемым именем ContosoMonitor.
Первая команда использует командлет get-SCOMNotificationSubscriber для получения подписчиков и хранения результата в переменной $Subscriber.
Вторая команда использует командлет get-SCOMNotificationChannel для получения канала уведомлений и сохраняет результат в переменной $Channel.
Третья команда использует командлет Get-SCOMMonitor и сохраняет результат в переменной $Monitor.
Четвертая команда сохраняет xml-критерии в переменной $Criteria.
Пятая команда использует командлет Add-SCOMNotificationSubscription с параметрами Name, подписчика, Channelи условий.
Параметры
-BccSubscriber
Задает массив подписчиков для слепой углеродной копии (BCC) в сообщении для подписки.
Свойства параметра
| Тип: | NotificationRecipient[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-CcSubscriber
Задает массив подписчиков в углеродную копию (CC) в сообщении для подписки.
Свойства параметра
| Тип: | NotificationRecipient[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Channel
Задает массив каналов уведомлений. Чтобы получить объект канала уведомлений, используйте командлет Get-SCOMNotificationChannel.
Свойства параметра
| Тип: | Object[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ComputerName
Задает массив имен компьютеров. Командлет устанавливает временные подключения с группами управления для этих компьютеров. Вы можете использовать имена NetBIOS, IP-адреса или полные доменные имена (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает объект PSCredential для подключения группы управления.
Чтобы получить объект PSCredential, используйте командлет Get-Credential.
Дополнительные сведения см. в Get-Help Get-Credential.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Criteria
Задает xml-файл условий, указывающий, как фильтровать оповещения для этой подписки. Критерии могут фильтроваться по определенным правилам или мониторам или свойствам оповещения, но не могут фильтроваться по классам или группам.
Вы можете вручную скопировать xml-файл условий из существующей подписки.
Чтобы получить xml-файл условий из существующей подписки, используйте эту модель: $subscription = Get-SCOMNotificationSubscription | Select-Object -First 1 $criteria = $subscription.Configuration.Criteria.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 3 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Delay
Указывает задержку в HH:MM:SS для отправки уведомлений, если условия остаются неизменными в течение этого периода времени. По умолчанию Operations Manager немедленно отправляет уведомления.
Свойства параметра
| Тип: | TimeSpan |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Description
Указывает описание подписки на уведомление. Если не указать описание, параметр по умолчанию использует значение параметра DisplayName.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Disabled
Указывает, что командлет создает подписку, но оставляет ее в отключенном состоянии.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisplayName
Указывает отображаемое имя подписки. Если не указать описание, параметр по умолчанию использует значение параметра Name.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя подписки.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-OnlyOnResolutionChange
Указывает, что уведомление возникает только при изменении состояния разрешения оповещения.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-PollingInterval
Задает интервал опроса для оповещений. Если этот параметр не указан, интервал по умолчанию по умолчанию — 1 минуту.
Свойства параметра
| Тип: | TimeSpan |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-SCSession
Задает массив объектов подключения
Свойства параметра
| Тип: | Connection[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Subscriber
Задает массив подписчиков для этой подписки. Чтобы получить объект подписчика уведомления, используйте командлет get-SCOMNotificationSubscriber.
Свойства параметра
| Тип: | NotificationRecipient[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.