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 番目のコマンドでは、 Add-SCOMNotificationSubscription コマンドレットを Name、 Subscriber、 Channel の各パラメーターと共に使用します。
例 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 番目のコマンドでは、 Add-SCOMNotificationSubscription コマンドレットを Name、 Subscriber、 Channel の各パラメーターと共に使用します。
例 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 番目のコマンドでは、 Add-SCOMNotificationSubscription コマンドレットを Name、 Subscriber、 Channel の各パラメーターと共に使用します。 コマンドレットは、結果を $Subscription 変数に格納します。
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 番目のコマンドでは、 Add-SCOMNotificationSubscription コマンドレットを Name、 Subscriber、 Channel の各パラメーターと共に使用します。 コマンドレットは、結果を $Subscription 変数に格納します。
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 番目のコマンドでは、Name、Subscriber、Channel、Criteria の各パラメーターで Add-SCOMNotificationSubscription コマンドレットを使用します。
パラメーター
-BccSubscriber
サブスクリプションのメッセージに対してブラインド カーボン コピー (BCC) するサブスクライバーの配列を指定します。
Type: | NotificationRecipient[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CcSubscriber
サブスクリプションのメッセージでカーボン コピー (CC) するサブスクライバーの配列を指定します。
Type: | NotificationRecipient[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Channel
通知チャネルの配列を指定します。 通知チャネル オブジェクトを取得するには、 Get-SCOMNotificationChannel コマンドレットを 使用します。
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
管理グループ接続の PSCredential オブジェクトを指定します。
PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細を表示するには「Get-Help Get-Credential
」を入力します。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Criteria
このサブスクリプションのアラートをフィルター処理する方法を示す抽出条件 xml を指定します。 条件は、特定のルールやモニター、またはアラートのプロパティでフィルター処理できますが、クラスまたはグループではフィルター処理できません。
既存のサブスクリプションから抽出条件 xml を手動でコピーできます。
既存のサブスクリプションから抽出条件 xml を取得するには、次のモデルを使用します: $subscription = Get-SCOMNotificationSubscription | Select-Object -First 1 $criteria = $subscription.Configuration.Criteria
。
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Delay
この期間に条件が変更されない場合に通知を送信するための遅延を HH:MM:SS で指定します。 既定では、Operations Manager は通知をすぐに送信します。
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Description
通知サブスクリプションの説明を指定します。 説明を指定しない場合、パラメーターの既定値は DisplayName パラメーターの値になります。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Disabled
コマンドレットによってサブスクリプションが作成され、無効な状態のままにされることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
サブスクリプションの表示名を指定します。 説明を指定しない場合、パラメーターの既定値は Name パラメーターの値になります。
Type: | String |
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 |
-OnlyOnResolutionChange
アラートの解決状態が変更された場合にのみ通知が発生することを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PollingInterval
アラートのポーリング間隔を指定します。 このパラメーターを指定しない場合、間隔の既定値は 1 分です。
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SCSession
Connection オブジェクトの配列を指定します。 Connection オブジェクトを取得するには、Get-SCManagementGroupConnection コマンドレットを使用します。
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Subscriber
このサブスクリプションのサブスクライバーの配列を指定します。 通知サブスクライバー オブジェクトを取得するには、 Get-SCOMNotificationSubscriber コマンドレットを 使用します。
Type: | NotificationRecipient[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |