Add-SCOMNotificationChannel

Модуль:: OperationsManager Module

Добавляет канал уведомлений в Operations Manager.

Синтаксис

UsingSMTP (по умолчанию)

Add-SCOMNotificationChannel
    [-Name] <String>
    [-From] <String>
    -Server <String>
    -Body <String>
    [-Port <UInt32>]
    [-DisplayName <String>]
    [-Description <String>]
    [-ReplyTo <String>]
    [-Header <Hashtable>]
    [-Anonymous]
    [-ExternalEmail]
    [-ExternalEmailRunasProfile <String>]
    [-BackupSmtpServer <String[]>]
    [-MaxPrimaryRecipientsPerMail <Int32>]
    [-PrimaryRetryInterval <TimeSpan>]
    [-Subject <String>]
    [-BodyAsHtml]
    [-Encoding <String>]
    [-NoSubjectEncoding]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UsingSIP

Add-SCOMNotificationChannel
    [-Name] <String>
    [-UserName] <Uri>
    -Server <String>
    -Body <String>
    [-Port <UInt32>]
    [-DisplayName <String>]
    [-Description <String>]
    [-ContentType <String>]
    [-SipProtocol <SipTransportProtocol>]
    [-SipAuthentication <SipNotificationAuthenticationProtocols>]
    [-PreferredUserName <String>]
    [-Encoding <String>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CommandAction

Add-SCOMNotificationChannel
    [-Name] <String>
    [-ApplicationPath] <String>
    [[-Argument] <String>]
    [-DisplayName <String>]
    [-Description <String>]
    [-WorkingDirectory <String>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UsingSMS

Add-SCOMNotificationChannel
    [-Name] <String>
    [[-Device] <String>]
    [[-BackupDevice] <String[]>]
    -Body <String>
    [-DisplayName <String>]
    [-Description <String>]
    [-PrimaryRetryInterval <TimeSpan>]
    [-DeviceEnumerationInterval <TimeSpan>]
    [-Sms]
    [-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
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

UsingSMTP

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

-ApplicationPath

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

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

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

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

CommandAction

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

-Argument

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

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

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

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

CommandAction

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

-BackupDevice

Задает массив вторичных SMS-устройств.

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

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

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

UsingSMS

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

-BackupSmtpServer

Задает массив резервных SMTP-серверов. Серверы резервного копирования используют ту же конфигурацию, что и основной SMTP-сервер.

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

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

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

UsingSMTP

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

-Body

Указывает текст сообщения уведомления.

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

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

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

UsingSMTP

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

UsingSIP

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

UsingSMS

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

-BodyAsHtml

Указывает, что служба форматирует текст сообщения как HTML.

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

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

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

UsingSMTP

Position:	Named
Обязательно:	False
Значение из конвейера:	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

-ContentType

Указывает тип контента мгновенных сообщений. По умолчанию тип контента text/plain.

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

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

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

UsingSIP

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

-Credential

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

Если указать компьютер в параметре ComputerName, используйте учетную запись, доступ к которому имеется. По умолчанию используется текущий пользователь.

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

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

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

(All)

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

-Description

Указывает описание канала уведомлений. Если значение не задано, по умолчанию используется параметр DisplayName.

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

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

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

(All)

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

-Device

Указывает основное SMS-устройство.

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

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

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

UsingSMS

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

-DeviceEnumerationInterval

Указывает интервал времени между sms-уведомлениями. По умолчанию канал уведомлений ожидает 10 секунд.

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

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

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

UsingSMS

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

-DisplayName

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

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

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

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

(All)

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

-Encoding

Задает формат кодирования для сообщения уведомления. По умолчанию канал SMTP использует кодировку UTF-8. Канал обмена мгновенными сообщениями также использует кодировку UTF-8 по умолчанию. По умолчанию канал SMS использует кодировку по умолчанию, но может использовать кодировку Юникода.

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

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

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

UsingSMTP

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

UsingSIP

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

UsingSMS

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

-ExternalEmail

Указывает, следует ли использовать внешнюю электронную почту.

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

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

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

UsingSMTP

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

-ExternalEmailRunasProfile

Задает профиль запуска от имени для внешней электронной почты.

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

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

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

UsingSMTP

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

-From

Задает заголовок From в сообщении электронной почты уведомления.

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

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

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

UsingSMTP

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

Задает заголовки в виде пар "ключ-значение" в сообщении электронной почты уведомления.

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

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

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

UsingSMTP

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

-MaxPrimaryRecipientsPerMail

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

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

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

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

UsingSMTP

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

-Name

Указывает имя канала уведомлений.

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

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

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

(All)

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

-NoSubjectEncoding

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

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

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

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

UsingSMTP

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

-Port

Указывает номер порта для канала.

По умолчанию канал SMTP использует порт 25. Канал обмена мгновенными сообщениями, использующий TCP, использует порт 5060 по умолчанию, а канал обмена мгновенными сообщениями, использующий протокол TLS, по умолчанию использует порт 5061.

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

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

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

UsingSMTP

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

UsingSIP

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

-PreferredUserName

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

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

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

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

UsingSIP

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

-PrimaryRetryInterval

Задает интервал повтора. Служба пытается вернуться на основной SMTP-сервер или SMS-устройство. По умолчанию интервал составляет пять минут.

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

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

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

UsingSMTP

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

UsingSMS

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

-ReplyTo

Задает заголовок "Ответ на запрос" в сообщении электронной почты уведомления.

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

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

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

UsingSMTP

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

-SCSession

Задает массив объектов подключения . Чтобы получить объект connection , используйте командлет Get-SCManagementGroupConnection.

Введите объект подключения для группы управления, например объект, который возвращает командлет Get-SCManagementGroupConnection.

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

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

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

(All)

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

-Server

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

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

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

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

UsingSMTP

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

UsingSIP

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

-SipAuthentication

Указывает механизм проверки подлинности протокола SIP (NTLM или Kerberos) для каналов обмена мгновенными сообщениями. По умолчанию проверка подлинности SIP использует проверку подлинности NTLM.

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

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

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

UsingSIP

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

-SipProtocol

Задает транспортный протокол SIP (TCP или TLS) для каналов обмена мгновенными сообщениями. По умолчанию SIP использует TCP в качестве транспортного протокола.

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

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

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

UsingSIP

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

-Sms

Указывает, что командлет отправляет уведомления с помощью SMS.

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

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

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

UsingSMS

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

-Subject

Задает строку темы для сообщения электронной почты уведомления.

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

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

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

UsingSMTP

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

-UserName

Задает возвращаемый адрес для обмена мгновенными сообщениями.

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

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

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

UsingSIP

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

-WhatIf

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

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

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

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

(All)

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

-WorkingDirectory

Указывает рабочий каталог для канала команд. По умолчанию канал команд использует %systemdrive% в качестве рабочего каталога.

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

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

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

CommandAction

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

CommonParameters

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