Add-SCOMNotificationChannel

模組:

OperationsManager

在 Operations Manager 中新增通知通道。

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

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：新增 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"

本範例會新增具有 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) 伺服器傳送電子郵件通知。

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

指定主要SMS裝置。

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DeviceEnumerationInterval

指定SMS通知之間的時間間隔。 根據預設，通知通道會等候 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，而使用傳輸層安全性的 IM 通道 (TLS) 預設會使用埠 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 會使用 SMS 傳送通知。

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

相關連結

• Get-SCOMNotificationChannel
• Remove-SCOMNotificationChannel