Add-SCOMNotificationChannel
Добавляет канал уведомлений в Operations Manager.
Синтаксис
Add-SCOMNotificationChannel
[-Name] <String>
[-Port <UInt32>]
[-DisplayName <String>]
[-Description <String>]
-Server <String>
[-From] <String>
[-ReplyTo <String>]
[-Header <Hashtable>]
[-Anonymous]
[-ExternalEmail]
[-ExternalEmailRunasProfile <String>]
[-BackupSmtpServer <String[]>]
[-MaxPrimaryRecipientsPerMail <Int32>]
[-PrimaryRetryInterval <TimeSpan>]
[-Subject <String>]
-Body <String>
[-BodyAsHtml]
[-Encoding <String>]
[-NoSubjectEncoding]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMNotificationChannel
[-Name] <String>
[-Port <UInt32>]
[-DisplayName <String>]
[-Description <String>]
[-UserName] <Uri>
[-ContentType <String>]
-Server <String>
[-SipProtocol <SipTransportProtocol>]
[-SipAuthentication <SipNotificationAuthenticationProtocols>]
[-PreferredUserName <String>]
-Body <String>
[-Encoding <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMNotificationChannel
[-Name] <String>
[-DisplayName <String>]
[-Description <String>]
[-ApplicationPath] <String>
[[-Argument] <String>]
[-WorkingDirectory <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMNotificationChannel
[-Name] <String>
[-DisplayName <String>]
[-Description <String>]
[-PrimaryRetryInterval <TimeSpan>]
[-DeviceEnumerationInterval <TimeSpan>]
[-Sms]
[[-Device] <String>]
[[-BackupDevice] <String[]>]
-Body <String>
[-Encoding <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Командлет add-SCOMNotificationChannel добавляет канал уведомлений в System Center Operations Manager. Каналы уведомлений сообщают администраторам оповещений или выполняют автоматизацию в ответ на оповещение. Канал уведомлений использует механизм доставки в Operations Manager, например электронную почту, мгновенные сообщения (мгновенные сообщения), службу коротких сообщений (SMS) или команду для доставки уведомлений.
Примеры
Пример 1. Добавление канала уведомлений
PS C:\>$Subject = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> $Body = "Owner is `$Data[Default='Not Present']/Context/DataItem/AlertOwner`$"
PS C:\> Add-SCOMNotificationChannel -Name "Contoso.Email" -Server "mail.contoso.com" -From "scom@contoso.net" -Subject $Subject -Body $BodyВ этом примере добавляется стандартный канал электронной почты SMTP.
Первая команда сохраняет строку темы в переменной с именем $Subject.
Вторая команда сохраняет текст сообщения в переменной с именем $Body.
Третья команда использует командлет Add-SCOMNotificationChannel для добавления канала электронной почты SMTP.
Пример 2. Добавление канала уведомлений для обмена мгновенными сообщениями
PS C:\>$Body = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> Add-SCOMNotificationChannel -Name "Contoso.IM" -Server "sipserver.contoso.com" -UserName 'sip:scomadmin' -Body $BodyВ этом примере добавляется канал обмена мгновенными сообщениями с возвращаемым адресом scomadmin.
Первая команда сохраняет текст сообщения в переменной с именем $Body.
Вторая команда использует командлет Add-SCOMNotificationChannel для добавления канала обмена мгновенными сообщениями.
Пример 3. Добавление канала уведомлений для SMS
PS C:\>$Body = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> Add-SCOMNotificationChannel -Sms -Name "Contoso.SMS" -Body $Body -Encoding "Unicode"В этом примере добавляется SMS-канал с кодировкой Юникода.
Первая команда сохраняет текст сообщения в переменной с именем $Body.
Вторая команда использует командлет Add-SCOMNotificationChannel для добавления канала SMS.
Пример 4. Добавление канала уведомлений команды
PS C:\>$Path = "C:\OnNotify.exe"
PS C:\> $Arg = "/notify /owner `"`$Data[Default='Not Present']/Context/DataItem/AlertOwner`$`""
PS C:\> $WorkingDir = "C:\"
PS C:\> Add-SCOMNotificationChannel -Name "Contoso.Command" -ApplicationPath $Path -Argument $Arg -WorkingDirectory $WorkingDirВ этом примере добавляется канал уведомлений команды, который запускает программу OnNotify.exe.
Первая команда сохраняет путь к исполняемому файлу в переменной с именем $Path.
Вторая команда сохраняет аргументы в переменной с именем $Arg.
Третья команда сохраняет рабочий каталог в переменной с именем $WorkingDir.
Четвертая команда использует командлет Add-SCOMNotificationChannel для добавления канала уведомлений команд.
Параметры
-Anonymous
Указывает, что анонимный сервер протокола SMTP отправляет уведомления по электронной почте.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ApplicationPath
Указывает путь приложения канала команд.
| Тип: | String |
| Position: | 1 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Argument
Указывает список аргументов в канале команд.
| Тип: | String |
| Position: | 2 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-BackupDevice
Задает массив вторичных SMS-устройств.
| Тип: | String[] |
| Position: | 3 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-BackupSmtpServer
Задает массив резервных SMTP-серверов. Серверы резервного копирования используют ту же конфигурацию, что и основной SMTP-сервер.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Body
Указывает текст сообщения уведомления.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-BodyAsHtml
Указывает, что служба форматирует текст сообщения как HTML.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | 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 |
-ContentType
Указывает тип контента мгновенных сообщений.
По умолчанию тип контента text/plain.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Credential
Указывает объект PSCredential для подключения группы управления.
Чтобы получить объект PSCredential, используйте командлет Get-Credential.
Для получения дополнительной информации введите "Get-Help Get-Credential".
Если указать компьютер в параметре ComputerName, используйте учетную запись, доступ к которому имеется. По умолчанию используется текущий пользователь.
| Тип: | PSCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Description
Указывает описание канала уведомлений. Если значение не задано, по умолчанию используется параметр DisplayName.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Device
Указывает основное SMS-устройство.
| Тип: | String |
| Position: | 2 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-DeviceEnumerationInterval
Указывает интервал времени между sms-уведомлениями. По умолчанию канал уведомлений ожидает 10 секунд.
| Тип: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-DisplayName
Указывает отображаемое имя канала уведомлений. Если значение не задано, значением по умолчанию является значение параметра Name.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Encoding
Задает формат кодирования для сообщения уведомления. По умолчанию канал SMTP использует кодировку UTF-8. Канал обмена мгновенными сообщениями также использует кодировку UTF-8 по умолчанию. По умолчанию канал SMS использует кодировку по умолчанию, но может использовать кодировку Юникода.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ExternalEmail
Указывает, следует ли использовать внешнюю электронную почту.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ExternalEmailRunasProfile
Задает профиль запуска от имени для внешней электронной почты.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-From
Задает заголовок From в сообщении электронной почты уведомления.
| Тип: | String |
| Position: | 2 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Header
Задает заголовки в виде пар "ключ-значение" в сообщении электронной почты уведомления.
| Тип: | Hashtable |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-MaxPrimaryRecipientsPerMail
Указывает максимальное число получателей для сообщения электронной почты уведомления.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Name
Указывает имя канала уведомлений.
| Тип: | String |
| Position: | 1 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-NoSubjectEncoding
Указывает, что командлет не кодирует строку темы электронной почты.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Port
Указывает номер порта для канала.
По умолчанию канал SMTP использует порт 25. Канал обмена мгновенными сообщениями, использующий TCP, использует порт 5060 по умолчанию, а канал обмена мгновенными сообщениями, использующий протокол TLS, по умолчанию использует порт 5061.
| Тип: | UInt32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PreferredUserName
Указывает предпочтительное имя пользователя канала обмена мгновенными сообщениями.
Если значение не задано, значение по умолчанию — это значение параметра имени пользователя
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PrimaryRetryInterval
Задает интервал повтора. Служба пытается вернуться на основной SMTP-сервер или SMS-устройство. По умолчанию интервал составляет пять минут.
| Тип: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ReplyTo
Задает заголовок "Ответ на запрос" в сообщении электронной почты уведомления.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SCSession
Задает массив объектов подключения
Введите объект подключения для группы управления, например объект, который возвращает командлет Get-SCManagementGroupConnection.
| Тип: | Connection[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Server
Указывает сервер, предоставляющий каналы SMTP и мгновенных сообщений для уведомлений.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SipAuthentication
Указывает механизм проверки подлинности протокола SIP (NTLM или Kerberos) для каналов обмена мгновенными сообщениями. По умолчанию проверка подлинности SIP использует проверку подлинности NTLM.
| Тип: | SipNotificationAuthenticationProtocols |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SipProtocol
Задает транспортный протокол SIP (TCP или TLS) для каналов обмена мгновенными сообщениями. По умолчанию SIP использует TCP в качестве транспортного протокола.
| Тип: | SipTransportProtocol |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Sms
Указывает, что командлет отправляет уведомления с помощью SMS.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Subject
Задает строку темы для сообщения электронной почты уведомления.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-UserName
Задает возвращаемый адрес для обмена мгновенными сообщениями.
| Тип: | Uri |
| Position: | 2 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WorkingDirectory
Указывает рабочий каталог для канала команд. По умолчанию канал команд использует %systemdrive% в качестве рабочего каталога.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |