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 コマンドレットは、System Center - Operations Manager に通知チャネルを追加します。 通知チャネルは、管理者にアラートを通知するか、アラートに応答して自動化を実行します。 通知チャネルでは、電子メール、インスタント メッセージング (IM)、ショート メッセージ サービス (SMS)、コマンドなど、Operations Manager の配信メカニズムを使用して通知を配信します。
例
例 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 という名前の変数に格納します。
2 番目のコマンドは、メッセージ本文を $Body という名前の変数に格納します。
3 番目のコマンドでは、Add-SCOMNotificationChannel コマンドレットを使用して 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 という名前の変数に格納します。
2 番目のコマンドでは、Add-SCOMNotificationChannel コマンドレットを使用して 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 という名前の変数に格納します。
2 番目のコマンドでは、Add-SCOMNotificationChannel コマンドレットを使用して 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 という名前の変数に格納します。
2 番目のコマンドは、引数を $Arg という名前の変数に格納します。
3 番目のコマンドは、作業ディレクトリを $WorkingDir という名前の変数に格納します。
4 番目のコマンドでは、Add-SCOMNotificationChannel コマンドレットを使用して、コマンド通知チャネルを追加します。
パラメーター
-Anonymous
匿名の簡易メール転送プロトコル (SMTP) サーバーが電子メール通知を送信することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ApplicationPath
コマンド チャネルのアプリケーション パスを指定します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Argument
コマンド チャネルの引数リストを指定します。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-BackupDevice
セカンダリ SMS デバイスの配列を指定します。
| 型: | String[] |
| 配置: | 3 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-BackupSmtpServer
バックアップ SMTP サーバーの配列を指定します。 バックアップ サーバーでは、プライマリ SMTP サーバーと同じ構成が使用されます。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Body
通知メッセージの本文を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-BodyAsHtml
サービスがメッセージの本文を HTML として書式設定することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ComputerName
コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ContentType
IM のコンテンツ タイプを指定します。
既定では、コンテンツ タイプは text/plainです。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Credential
管理グループ接続 PSCredential オブジェクトを指定します。
PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細については、「Get-Help Get-Credential」と入力します。
ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
通知チャネルの説明を指定します。 値を設定しない場合、既定値は DisplayName パラメーターの値です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Device
プライマリ SMS デバイスを指定します。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-DeviceEnumerationInterval
SMS 通知の間隔を指定します。 既定では、通知チャネルは 10 秒待機します。
| 型: | TimeSpan |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-DisplayName
通知チャネルの表示名を指定します。 値を設定しない場合、既定値は Name パラメーターの値です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Encoding
通知メッセージのエンコード形式を指定します。 SMTP チャネルでは、既定で UTF-8 エンコードが使用されます。 IM チャネルでは、既定で UTF-8 エンコードも使用されます。 SMS チャネルでは既定で既定のエンコードが使用されますが、代わりに Unicode エンコードを使用できます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ExternalEmail
外部メールを使用するかどうかを指定します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ExternalEmailRunasProfile
外部メールの実行プロファイルを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-From
通知電子メール メッセージの From ヘッダーを指定します。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Header
通知メール メッセージのヘッダーをキーと値のペアとして指定します。
| 型: | Hashtable |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-MaxPrimaryRecipientsPerMail
通知メール メッセージの受信者の最大数を指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
通知チャネルの名前を指定します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-NoSubjectEncoding
コマンドレットが電子メールの件名行をエンコードしないことを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Port
チャネルのポート番号を指定します。
SMTP チャネルでは、既定でポート 25 が使用されます。 TCP を使用する IM チャネルでは既定でポート 5060 が使用され、トランスポート層セキュリティ (TLS) を使用する IM チャネルでは既定でポート 5061 が使用されます。
| 型: | UInt32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PreferredUserName
IM チャネルの優先ユーザー名を指定します。 値を設定しない場合、既定値は Username パラメーターの値です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PrimaryRetryInterval
再試行間隔を指定します。 サービスは、プライマリ SMTP サーバーまたは SMS デバイスへの切り替えを試みます。 既定では、間隔は 5 分です。
| 型: | TimeSpan |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ReplyTo
通知メール メッセージの返信先ヘッダーを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SCSession
Connection オブジェクトの配列
Get-SCManagementGroupConnection コマンドレットが返す接続オブジェクトなど、管理グループの接続オブジェクトを入力します。
| 型: | Connection[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Server
通知用の SMTP チャネルと IM チャネルを提供するサーバーを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SipAuthentication
IM チャネルのセッション開始プロトコル (SIP) 認証メカニズム (NTLM または Kerberos) を指定します。 既定では、SIP 認証では NTLM 認証が使用されます。
| 型: | SipNotificationAuthenticationProtocols |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SipProtocol
IM チャネルの SIP トランスポート プロトコル (TCP または TLS) を指定します。 既定では、SIP はトランスポート プロトコルとして TCP を使用します。
| 型: | SipTransportProtocol |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Sms
コマンドレットが SMS を使用して通知を送信することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Subject
通知メール メッセージの件名行を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-UserName
IM のリターン アドレスを指定します。
| 型: | Uri |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WorkingDirectory
コマンド チャネルの作業ディレクトリを指定します。 既定では、コマンド チャネルは作業ディレクトリとして %systemdrive% を使用します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |