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>] 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
表示匿名的 Simple Mail Transfer Protocol （SMTP） 伺服器傳送電子郵件通知。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ApplicationPath
指定命令通道的應用程式路徑。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Argument
指定命令通道的自變數清單。
| 類型: | String |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-BackupDevice
指定次要SMS裝置的陣列。
| 類型: | String[] |
| Position: | 3 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-BackupSmtpServer
指定備份 SMTP 伺服器的陣列。 備份伺服器會使用與主要 SMTP 伺服器相同的組態。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Body
指定通知訊息的本文。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-BodyAsHtml
表示服務會將訊息的本文格式化為 HTML。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ComputerName
指定計算機名稱的陣列。 Cmdlet 會為這些電腦建立管理群組的暫時連線。 您可以使用 NetBIOS 名稱、IP 位址或完整功能變數名稱 （FQDN）。 若要指定本機計算機，請輸入計算機名稱、localhost 或點 （.）。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ContentType
指定 IM 的內容類型。
根據預設，內容類型為 text/plain。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Credential
指定管理群組連線 PSCredential 物件。
若要取得 Get-Help Get-Credential」。
如果您在 ComputerName 參數中指定電腦，請使用可存取該電腦的帳戶。 預設值為目前的使用者。
| 類型: | PSCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定通知通道的描述。 如果您未設定值，預設值為 DisplayName 參數的值。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Device
指定主要SMS裝置。
| 類型: | String |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DeviceEnumerationInterval
指定SMS通知之間的時間間隔。 根據預設，通知通道會等候 10 秒。
| 類型: | TimeSpan |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DisplayName
指定通知通道的顯示名稱。 如果您未設定值，預設值為 Name 參數的值。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Encoding
指定通知訊息的編碼格式。 SMTP 通道預設會使用UTF-8編碼。 IM 通道預設也會使用 UTF-8 編碼。 SMS 通道預設會使用預設編碼，但可以替代使用 Unicode 編碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ExternalEmail
指定是否要使用外部電子郵件。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ExternalEmailRunasProfile
指定外部電子郵件的執行身分設定檔。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-From
指定通知電子郵件訊息中的From標頭。
| 類型: | String |
| Position: | 2 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Header
在通知電子郵件訊息中，指定標頭做為機碼/值組。
| 類型: | Hashtable |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-MaxPrimaryRecipientsPerMail
指定通知電子郵件訊息的收件者數目上限。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定通知通道的名稱。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-NoSubjectEncoding
表示 Cmdlet 不會編碼電子郵件主旨行。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Port
指定通道的埠號碼。
SMTP 通道預設會使用埠 25。 默認使用 TCP 的 IM 通道會使用埠 5060，而使用傳輸層安全性的 IM 通道預設會使用埠 5061。
| 類型: | UInt32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PreferredUserName
指定IM通道的慣用用戶名稱。 如果您未設定值，則預設值為 Username 參數的值。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PrimaryRetryInterval
指定重試間隔。 服務會嘗試切換回主要 SMTP 伺服器或 SMS 裝置。 根據預設，間隔為五分鐘。
| 類型: | TimeSpan |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ReplyTo
指定通知電子郵件訊息中的回復標頭。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SCSession
指定 connection 物件的
輸入管理群組的連接物件，例如 Get-SCManagementGroupConnection Cmdlet 傳回的連線物件。
| 類型: | Connection[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Server
指定提供通知 SMTP 和 IM 通道的伺服器。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SipAuthentication
指定 IM 通道的工作階段初始通訊協定 （SIP） 驗證機制 （NTLM 或 Kerberos）。 根據預設，SIP 驗證會使用NTLM驗證。
| 類型: | SipNotificationAuthenticationProtocols |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SipProtocol
指定 IM 通道的 SIP 傳輸通訊協定 （TCP 或 TLS）。 根據預設，SIP 會使用 TCP 作為傳輸通訊協定。
| 類型: | SipTransportProtocol |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Sms
指出 Cmdlet 會使用 SMS 傳送通知。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Subject
指定通知電子郵件訊息的主旨列。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-UserName
指定 IM 的傳回位址。
| 類型: | Uri |
| Position: | 2 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WorkingDirectory
指定命令通道的工作目錄。 根據預設，命令通道會使用 %systemdrive% 作為工作目錄。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |