Add-SCOMNotificationSubscription
Добавляет подписку на уведомление.
Синтаксис
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[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-CcSubscriber
Задает массив подписчиков в углеродную копию (CC) в сообщении для подписки.
| Тип: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Channel
Задает массив каналов уведомлений. Чтобы получить объект канала уведомлений, используйте командлет Get-SCOMNotificationChannel.
| Тип: | Object[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ComputerName
Задает массив имен компьютеров. Командлет устанавливает временные подключения с группами управления для этих компьютеров. Вы можете использовать имена NetBIOS, IP-адреса или полные доменные имена (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).
| Тип: | 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.
| Тип: | PSCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Criteria
Задает xml-файл условий, указывающий, как фильтровать оповещения для этой подписки. Критерии могут фильтроваться по определенным правилам или мониторам или свойствам оповещения, но не могут фильтроваться по классам или группам.
Вы можете вручную скопировать xml-файл условий из существующей подписки.
Чтобы получить xml-файл условий из существующей подписки, используйте эту модель: $subscription = Get-SCOMNotificationSubscription | Select-Object -First 1 $criteria = $subscription.Configuration.Criteria.
| Тип: | String |
| Position: | 3 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Delay
Указывает задержку в HH:MM:SS для отправки уведомлений, если условия остаются неизменными в течение этого периода времени. По умолчанию Operations Manager немедленно отправляет уведомления.
| Тип: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Description
Указывает описание подписки на уведомление. Если не указать описание, параметр по умолчанию использует значение параметра DisplayName.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Disabled
Указывает, что командлет создает подписку, но оставляет ее в отключенном состоянии.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisplayName
Указывает отображаемое имя подписки. Если не указать описание, параметр по умолчанию использует значение параметра Name.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Name
Указывает имя подписки.
| Тип: | String |
| Position: | 1 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-OnlyOnResolutionChange
Указывает, что уведомление возникает только при изменении состояния разрешения оповещения.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PollingInterval
Задает интервал опроса для оповещений. Если этот параметр не указан, интервал по умолчанию по умолчанию — 1 минуту.
| Тип: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SCSession
Задает массив объектов подключения
| Тип: | Connection[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Subscriber
Задает массив подписчиков для этой подписки. Чтобы получить объект подписчика уведомления, используйте командлет get-SCOMNotificationSubscriber.
| Тип: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |