Add-SCOMNotificationSubscription
通知サブスクリプションを追加します。
構文
Add-SCOMNotificationSubscription
[-Name] <String>
[-DisplayName <String>]
[-Description <String>]
[[-Criteria] <String>]
[-OnlyOnResolutionChange]
[-PollingInterval <TimeSpan>]
[-Delay <TimeSpan>]
-Subscriber <NotificationRecipient[]>
[-CcSubscriber <NotificationRecipient[]>]
[-BccSubscriber <NotificationRecipient[]>]
-Channel <Object[]>
[-Disabled]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Add-SCOMNotificationSubscription コマンドレットは、System Center - Operations Manager で通知サブスクリプションを追加します。
このリリースでは、条件に基づいてサブスクリプションのスコープを設定するためのコマンドレットのサポートはありませんが、SCOM SDK に直接アクセスすることで、Windows PowerShell を使用してこの結果を実現できます。
例
例 1: 通知サブスクリプションを追加する
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> Add-SCOMNotificationSubscription -Name "NewSubscription1" -Subscriber $Subscriber -Channel $Channel
次の使用例は、すべてのアラートに新しい通知サブスクリプションを追加します。
最初のコマンドは、Get-SCOMNotificationSubscriber コマンドレットを使用してサブスクライバーを取得し、結果を $Subscriber 変数に格納します。
2 番目のコマンドは、Get-SCOMNotificationChannel コマンドレットを使用して通知チャネルを取得し、結果を$Channel変数に格納します。
3 番目のコマンドでは、
例 2: 条件を含む通知サブスクリプションを追加する
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> Add-SCOMNotificationSubscription -Name "NewSubscription2" -Subscriber $Subscriber -Channel $Channel -Delay "1:00:00" -Disabled
次の使用例は、すべてのアラートに対して新しい通知サブスクリプションを追加しますが、条件が 1 時間変更されていない場合にのみ通知します。 この例では、サブスクリプションが無効な状態で作成されます。
最初のコマンドは、Get-SCOMNotificationSubscriber コマンドレットを使用してサブスクライバーを取得し、結果を $Subscriber 変数に格納します。
2 番目のコマンドは、Get-SCOMNotificationChannel コマンドレットを使用して通知チャネルを取得し、結果を$Channel変数に格納します。
3 番目のコマンドでは、
例 3: 特定のクラスのインスタンスの新しいサブスクリプションを追加する
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> $Subscription = Add-SCOMNotificationSubscription -Name "NewSubscription3" -Subscriber $Subscriber -Channel $Channel
PS C:\> $HealthService = Get-SCOMClass -Name "Microsoft.SystemCenter.HealthService"
PS C:\> $Subscription.Configuration.MonitoringClassIds.Add( $HealthService.Id )
PS C:\> $Subscription.Update()
この例では、すべてのアラートに対して新しい通知サブスクリプションを追加し、Operations Manager SDK を使用して、HealthService クラスのインスタンスによって発生したアラートにサブスクリプションのスコープを設定します。
最初のコマンドは、Get-SCOMNotificationSubscriber コマンドレットを使用してサブスクライバーを取得し、結果を $Subscriber 変数に格納します。
2 番目のコマンドは、Get-SCOMNotificationChannel コマンドレットを使用して通知チャネルを取得し、結果を$Channel変数に格納します。
3 番目のコマンドでは、
4 番目のコマンドは、Get-SCOMClass コマンドレットを使用し、結果を $HealthService 変数に格納します。
5 番目のコマンドでは、$HealthService変数の ID を持つ Add メソッドを使用します。
6 番目のコマンドでは、Update メソッドを使用します。
例 4: SDK を使用して通知サブスクリプションを追加する
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> $Subscription = Add-SCOMNotificationSubscription -Name "NewSubscription4" -Subscriber $Subscriber -Channel $Channel
PS C:\> $WindowsComputers = Get-SCOMGroup -DisplayName "All Windows Computers"
PS C:\> $Subscription.Configuration.MonitoringObjectGroupIds.Add( $WindowsComputers.Id )
PS C:\> $Subscription.Update()
この例では、すべてのアラートに対して新しい通知サブスクリプションを追加し、Operations Manager SDK を使用して、すべての Windows コンピューター グループ内のインスタンスによって発生したアラートにサブスクリプションのスコープを設定します。
最初のコマンドは、Get-SCOMNotificationSubscriber コマンドレットを使用してサブスクライバーを取得し、結果を $Subscriber 変数に格納します。
2 番目のコマンドは、Get-SCOMNotificationChannel コマンドレットを使用して通知チャネルを取得し、結果を$Channel変数に格納します。
3 番目のコマンドでは、
4 番目のコマンドでは、Get-SCOMGroup コマンドレットを使用してすべての Windows コンピューター グループを取得し、結果を $WindowsComputers 変数に格納します。
5 番目のコマンドでは、$WindowsComputers変数の ID を持つ Add メソッドを使用します。
6 番目のコマンドでは、Update メソッドを使用します。
例 5: 特定のモニターの通知サブスクリプションを追加する
PS C:\>$Subscriber = Get-SCOMNotificationSubscriber -Name "John Smith","Sarah Jones"
PS C:\> $Channel = Get-SCOMNotificationChannel -DisplayName "EmailChannel"
PS C:\> $Monitor = Get-SCOMMonitor -DisplayName "ContosoMonitor"
PS C:\> $Criteria = @"
>><And xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
>><Expression>
>><SimpleExpression>
>><ValueExpression>
>><Property>ProblemId</Property>
>></ValueExpression>
>><Operator>Equal</Operator>
>><ValueExpression>
>><Value>$($monitor.Id)</Value>
>></ValueExpression>
>></SimpleExpression>
>></Expression>
>><Expression>
>><SimpleExpression>
>><ValueExpression>
>><Property>Severity</Property>
>></ValueExpression>
>><Operator>Equal</Operator>
>><ValueExpression>
>><Value>2</Value>
>></ValueExpression>
>></SimpleExpression>
>></Expression>
>>"@
PS C:\> Add-SCOMNotificationSubscription -Name "Subscription03" -Subscriber $Subscriber -Channel $Channel -Criteria $Criteria
この例では、ContosoMonitor という表示名を持つモニターによって発生したすべての重要なアラートに対して、新しい通知サブスクリプションを追加します。
最初のコマンドは、Get-SCOMNotificationSubscriber コマンドレットを使用してサブスクライバーを取得し、結果を $Subscriber 変数に格納します。
2 番目のコマンドは、Get-SCOMNotificationChannel コマンドレットを使用して通知チャネルを取得し、結果を$Channel変数に格納します。
3 番目のコマンドは、Get-SCOMMonitor コマンドレットを使用し、結果を $Monitor 変数に格納します。
4 番目のコマンドは、xml 条件を$Criteria変数に格納します。
5 番目のコマンドでは、Add-SCOMNotificationSubscription コマンドレットを使用し、Name、Subscriber、Channel、および Criteria パラメーターを使用します。
パラメーター
-BccSubscriber
サブスクリプションのメッセージに対するブラインド カーボン コピー (BCC) のサブスクライバーの配列を指定します。
型: | NotificationRecipient[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-CcSubscriber
サブスクリプションのメッセージのカーボン コピー (CC) のサブスクライバーの配列を指定します。
型: | NotificationRecipient[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Channel
通知チャネルの配列を指定します。 通知チャネル オブジェクトを取得するには、Get-SCOMNotificationChannel コマンドレットを使用します。
型: | Object[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ComputerName
コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Credential
管理グループ接続 PSCredential オブジェクトを指定します。
PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細については、「Get-Help Get-Credential
」と入力します。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Criteria
このサブスクリプションのアラートをフィルター処理する方法を示す抽出条件 xml を指定します。 抽出条件は、特定のルールやモニター、またはアラートのプロパティに基づいてフィルター処理できますが、クラスまたはグループではフィルター処理できません。
既存のサブスクリプションから抽出条件 xml を手動でコピーできます。
既存のサブスクリプションから抽出条件 xml を取得するには、次のモデルを使用します: $subscription = Get-SCOMNotificationSubscription | Select-Object -First 1 $criteria = $subscription.Configuration.Criteria
.
型: | String |
配置: | 3 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Delay
条件がこの期間変更されていない場合に通知を送信するための遅延を HH:MM:SS で指定します。 既定では、Operations Manager は通知を直ちに送信します。
型: | TimeSpan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Description
通知サブスクリプションの説明を指定します。 説明を指定しない場合、パラメーターは既定で DisplayName パラメーターの値になります。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Disabled
コマンドレットによってサブスクリプションが作成されるが、無効な状態のままにされることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisplayName
サブスクリプションの表示名を指定します。 説明を指定しない場合、パラメーターの既定値は Name パラメーターの値になります。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
サブスクリプションの名前を指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-OnlyOnResolutionChange
通知が発生するのは、アラートの解決状態が変更されたときにのみ行われることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PollingInterval
アラートのポーリング間隔を指定します。 このパラメーターを指定しない場合、間隔の既定値は 1 分です。
型: | TimeSpan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SCSession
Connection オブジェクトの配列
型: | Connection[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Subscriber
このサブスクリプションのサブスクライバーの配列を指定します。 通知サブスクライバー オブジェクトを取得するには、Get-SCOMNotificationSubscriber コマンドレットを使用します。
型: | NotificationRecipient[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |