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 |
在通知电子邮件中将标头指定为键值对。
| 类型: | 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。