Add-SCOMNotificationChannel

在 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 cmdlet 在 System Center - Operations Manager 中添加通知通道。 通知通道通知管理员警报,或者他们运行自动化以响应警报。 通知通道使用 Operations Manager 中的传递机制(如电子邮件、即时消息 (IM)、短信服务 (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 cmdlet 添加 SMTP 电子邮件通道。

示例 2:为 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

此示例添加一个返回地址为 scomadmin 的 IM 通道。

第一个命令将消息正文存储在名为 $Body 的变量中。

第二个命令使用 Add-SCOMNotificationChannel cmdlet 添加 IM 通道。

示例 3:添加短信通知通道

PS C:\>$Body = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> Add-SCOMNotificationChannel -Sms -Name "Contoso.SMS" -Body $Body -Encoding "Unicode"

此示例添加具有 Unicode 编码的 SMS 通道。

第一个命令将消息正文存储在名为 $Body 的变量中。

第二个命令使用 Add-SCOMNotificationChannel cmdlet 添加 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 cmdlet 添加命令通知通道。

参数

-Anonymous

指示匿名简单邮件传输协议 (SMTP) 服务器发送电子邮件通知。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ApplicationPath

指定命令通道的应用程序路径。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CommandAction
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Argument

为命令通道指定参数列表。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CommandAction
Position:2
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-BackupDevice

指定辅助 SMS 设备阵列。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

UsingSMS
Position:3
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-BackupSmtpServer

指定备份 SMTP 服务器的阵列。 备份服务器使用与主 SMTP 服务器相同的配置。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Body

指定通知消息的正文。

参数属性

类型:String
默认值:None
支持通配符:False
不显示: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
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ComputerName

指定一个包含计算机名称的数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 您可以使用 NetBIOS 名称、IP 地址或完全限定域名 (FQDN)。 若要指定本地计算机,请键入计算机名称、localhost 或点(.)。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContentType

指定 IM 的内容类型。 默认情况下,内容类型为 text/plain

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UsingSIP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Credential

为管理组连接指定 PSCredential 对象。 若要获取 PSCredential 对象,请使用 Get-Credential cmdlet。 有关详细信息,请键入“Get-Help Get-Credential”。

如果在 ComputerName 参数中指定计算机,请使用有权访问该计算机的帐户。 默认值为当前用户。

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Description

指定通知通道的说明。 如果未设置值,则默认值为 DisplayName 参数的值。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Device

指定主 SMS 设备。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMS
Position:2
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-DeviceEnumerationInterval

指定短信通知之间的时间间隔。 默认情况下,通知通道等待 10 秒。

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMS
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-DisplayName

指定通知通道的显示名称。 如果未设置值,则默认值为 Name 参数的值。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Encoding

指定通知消息的编码格式。 默认情况下,SMTP 通道使用 UTF-8 编码。 默认情况下,IM 通道还使用 UTF-8 编码。 默认情况下,SMS 通道使用默认编码,但也可以交替使用 Unicode 编码。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False
UsingSIP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False
UsingSMS
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ExternalEmail

指定是否使用外部电子邮件。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ExternalEmailRunasProfile

指定外部电子邮件的运行方式配置文件。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-From

指定通知电子邮件中的“发件人”标头。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:2
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Header

在通知电子邮件中将标头指定为键值对。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-MaxPrimaryRecipientsPerMail

指定通知电子邮件的最大收件人数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Name

指定通知通道的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-NoSubjectEncoding

指示 cmdlet 不对电子邮件主题行进行编码。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Port

指定通道的端口号。

默认情况下,SMTP 通道使用端口 25。 默认情况下,使用 TCP 的 IM 通道使用端口 5060,使用传输层安全性 (TLS) 的 IM 通道默认使用端口 5061。

参数属性

类型:UInt32
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False
UsingSIP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-PreferredUserName

指定 IM 通道的首选用户名。 如果未设置值,则默认值为 Username 参数的值。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UsingSIP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-PrimaryRetryInterval

指定重试间隔。 服务尝试切换回主 SMTP 服务器或 SMS 设备。 默认情况下,间隔为 5 分钟。

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False
UsingSMS
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ReplyTo

指定通知电子邮件中的 Reply-to 标头。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-SCSession

指定 Connection 对象的数组。 若要获取 Connection 对象,请使用 Get-SCManagementGroupConnection cmdlet。

输入管理组的连接对象,例如 Get-SCManagementGroupConnection cmdlet 返回的连接对象。

参数属性

类型:

Connection[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Server

指定为通知提供 SMTP 和 IM 通道的服务器。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False
UsingSIP
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-SipAuthentication

指定 IM 通道的会话启动协议 (SIP) 身份验证机制 (NTLM 或 Kerberos) 。 默认情况下,SIP 身份验证使用 NTLM 身份验证。

参数属性

类型:SipNotificationAuthenticationProtocols
默认值:None
支持通配符:False
不显示:False

参数集

UsingSIP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-SipProtocol

指定 IM 通道的 SIP 传输协议(TCP 或 TLS)。 默认情况下,SIP 使用 TCP 作为传输协议。

参数属性

类型:SipTransportProtocol
默认值:None
支持通配符:False
不显示:False

参数集

UsingSIP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Sms

指示 cmdlet 使用 SMS 发送通知。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMS
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Subject

指定通知电子邮件的主题行。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UsingSMTP
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-UserName

指定 IM 的返回地址。

参数属性

类型:Uri
默认值:None
支持通配符:False
不显示:False

参数集

UsingSIP
Position:2
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WorkingDirectory

指定命令通道的工作目录。 默认情况下,命令通道将 %systemdrive% 用作工作目录。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CommandAction
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters