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 cmdlet 在 System Center - Operations Manager 中添加通知通道。 通知通道将警报通知管理员，或者通知通道运行自动化来响应警报。 通知通道使用 Operations Manager 中的传递机制（如电子邮件、即时消息 (IM) 、短消息服务 (短信) 或命令）来传递通知。
示例
示例 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 编码的短信通道。
第一个命令将消息正文存储在名为 $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) 服务器 (匿名简单邮件传输协议发送电子邮件通知。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationPath
指定命令通道的应用程序路径。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Argument
指定命令通道的参数列表。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackupDevice
指定辅助 SMS 设备的数组。
| Type: | String[] |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BackupSmtpServer
指定备份 SMTP 服务器的数组。 备份服务器使用与主 SMTP 服务器相同的配置。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Body
指定通知消息的正文。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BodyAsHtml
指示服务将邮件正文的格式设置为 HTML。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
指定计算机的名称数组。 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名 (FQDN) 。 若要指定本地计算机，请键入该计算机名称、localhost 或句点 (.)。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContentType
指定 IM 的内容类型。
默认情况下，内容类型为 text/plain。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Credential
为管理组连接指定 PSCredential 对象。
若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。
有关详细信息，请键入“Get-Help Get-Credential”。
如果在 ComputerName 参数中指定计算机，请使用有权访问该计算机的帐户。 默认为当前用户。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定通知通道的说明。 如果未设置值，则默认值为 DisplayName 参数的值。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Device
指定主要短信设备。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DeviceEnumerationInterval
指定短信通知之间的时间间隔。 默认情况下，通知通道等待 10 秒。
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisplayName
指定通知通道的显示名称。 如果未设置值，则默认值为 Name 参数的值。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Encoding
指定通知消息的编码格式。 SMTP 通道默认使用 UTF-8 编码。 默认情况下，IM 通道还使用 UTF-8 编码。 默认情况下，SMS 通道使用默认编码，但可以交替使用 Unicode 编码。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExternalEmail
指定是否使用外部电子邮件。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExternalEmailRunasProfile
指定外部电子邮件的运行方式配置文件。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-From
指定通知电子邮件中的 From 标头。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Header
在通知电子邮件中将标头指定为键值对。
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MaxPrimaryRecipientsPerMail
指定通知电子邮件的最大收件人数。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定通知通道的名称。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoSubjectEncoding
指示 cmdlet 不对电子邮件主题行进行编码。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Port
指定通道的端口号。
SMTP 通道默认使用端口 25。 默认情况下，使用 TCP 的 IM 通道使用端口 5060，使用传输层安全性 (TLS) 的 IM 通道默认使用端口 5061。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PreferredUserName
指定 IM 通道的首选用户名。 如果未设置值，则默认值为 Username 参数的值。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrimaryRetryInterval
指定重试间隔。 服务尝试切换回主 SMTP 服务器或 SMS 设备。 默认情况下，间隔为五分钟。
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReplyTo
指定通知电子邮件中的“答复”标头。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
指定 Connection 对象的数组。 若要获取 Connection 对象，请使用 Get-SCManagementGroupConnection cmdlet。
输入管理组的连接对象，例如 Get-SCManagementGroupConnection cmdlet 返回的连接对象。
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Server
指定为通知提供 SMTP 和 IM 通道的服务器。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SipAuthentication
为 IM 通道指定会话初始协议 (SIP) 身份验证机制 (NTLM 或 Kerberos) 。 默认情况下，SIP 身份验证使用 NTLM 身份验证。
| Type: | SipNotificationAuthenticationProtocols |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SipProtocol
为 IM 通道指定 SIP 传输协议 (TCP 或 TLS) 。 默认情况下，SIP 使用 TCP 作为传输协议。
| Type: | SipTransportProtocol |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Sms
指示 cmdlet 使用短信发送通知。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Subject
指定通知电子邮件的主题行。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UserName
指定 IM 的返回地址。
| Type: | Uri |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkingDirectory
指定命令通道的工作目录。 默认情况下，命令通道使用 %systemdrive% 作为工作目录。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |