Add-SCOMNotificationChannel

Syntax

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>]

Description

The Add-SCOMNotificationChannel cmdlet adds a notification channel in System Center - Operations Manager. Notification channels inform administrators of an alert, or they run automation in response to an alert. A notification channel uses a delivery mechanism in Operations Manager, such as email, instant messaging (IM), Short Message Service (SMS), or command, to deliver notifications.

Examples

Example 1: Add a notification channel

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

This example adds a standard SMTP email channel.

The first command stores the subject line in the variable named $Subject.

The second command stores the message body in the variable named $Body.

The third command uses the Add-SCOMNotificationChannel cmdlet to add an SMTP email channel.

Example 2: Add a notification channel for IM

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

This example adds an IM channel that has a return address of scomadmin.

The first command stores the message body in the variable named $Body.

The second command uses the Add-SCOMNotificationChannel cmdlet to add an IM channel.

Example 3: Add a notification channel for 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"

This example adds an SMS channel that has Unicode encoding.

The first command stores the message body in the variable named $Body.

The second command uses the Add-SCOMNotificationChannel cmdlet to add an SMS channel.

Example 4: Add a command notification channel

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

This example adds a command notification channel that runs the OnNotify.exe program.

The first command stores the path to the executable file in the variable named $Path.

The second command stores the arguments in the variable named $Arg.

The third command stores the working directory in the variable named $WorkingDir.

The fourth command uses the Add-SCOMNotificationChannel cmdlet to add a command notification channel.

Parameters

-Anonymous

-ApplicationPath

-Argument

-BackupDevice

-BackupSmtpServer

-Body

-BodyAsHtml

-ComputerName

-Confirm

-ContentType

-Credential

-Description

-Device

-DeviceEnumerationInterval

-DisplayName

-Encoding

-ExternalEmail

-ExternalEmailRunasProfile

-From

-Header

-MaxPrimaryRecipientsPerMail

-Name

-NoSubjectEncoding

-Port

-PreferredUserName

-PrimaryRetryInterval

-ReplyTo

-SCSession

-Server

-SipAuthentication

-SipProtocol

-Sms

-Subject

-UserName

-WhatIf

-WorkingDirectory

Related Links

• Get-SCOMNotificationChannel
• Remove-SCOMNotificationChannel