Add-SCOMNotificationSubscription
Fügt ein Benachrichtigungsabonnement hinzu.
Syntax
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>] Beschreibung
Das Cmdlet Add-SCOMNotificationSubscription fügt ein Benachrichtigungsabonnement in System Center – Operations Manager hinzu.
In diesem Release gibt es keine Cmdletunterstützung für Bereichsabonnements basierend auf einem Kriterium, aber Sie können dieses Ergebnis durch Windows PowerShell erreichen, indem Sie direkt auf das SCOM SDK zugreifen.
Beispiele
Beispiel 1: Hinzufügen eines Benachrichtigungsabonnements
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 $ChannelIn diesem Beispiel wird ein neues Benachrichtigungsabonnement für alle Warnungen hinzugefügt.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber , um Abonnenten abzurufen und das Ergebnis in der variablen $Subscriber zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen, und speichert das Ergebnis in der variablen $Channel.
Der dritte Befehl verwendet das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber und Channel .
Beispiel 2: Hinzufügen eines Benachrichtigungsabonnements mit Bedingungen
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" -DisabledIn diesem Beispiel wird ein neues Benachrichtigungsabonnement für alle Warnungen hinzugefügt, aber nur benachrichtigt, wenn die Bedingungen 1 Stunde lang unverändert bleiben. Im Beispiel wird das Abonnement im deaktivierten Zustand erstellt.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber , um Abonnenten abzurufen und das Ergebnis in der variablen $Subscriber zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen, und speichert das Ergebnis in der variablen $Channel.
Der dritte Befehl verwendet das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber und Channel .
Beispiel 3: Hinzufügen eines neuen Abonnements für Instanzen einer bestimmten Klasse
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()In diesem Beispiel wird ein neues Benachrichtigungsabonnement für alle Warnungen hinzugefügt, und anschließend wird das Operations Manager SDK verwendet, um das Abonnement auf Warnungen einzugrenzen, die von Instanzen der HealthService-Klasse ausgelöst werden.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber , um Abonnenten abzurufen und das Ergebnis in der variablen $Subscriber zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen, und speichert das Ergebnis in der variablen $Channel.
Der dritte Befehl verwendet das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber und Channel . Das Cmdlet speichert das Ergebnis in der variablen $Subscription.
Der vierte Befehl verwendet das Cmdlet Get-SCOMClass und speichert das Ergebnis in der variablen $HealthService.
Der fünfte Befehl verwendet die Add-Methode mit der ID der variablen $HealthService.
Der sechste Befehl verwendet die Update-Methode.
Beispiel 4: Hinzufügen eines Benachrichtigungsabonnements mithilfe des 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()In diesem Beispiel wird ein neues Benachrichtigungsabonnement für alle Warnungen hinzugefügt, und anschließend wird das Operations Manager SDK verwendet, um das Abonnement auf Warnungen festzulegen, die von Instanzen in der Gruppe Alle Windows-Computer ausgelöst werden.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber , um Abonnenten abzurufen und das Ergebnis in der variablen $Subscriber zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen, und speichert das Ergebnis in der variablen $Channel.
Der dritte Befehl verwendet das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber und Channel . Das Cmdlet speichert das Ergebnis in der variablen $Subscription.
Der vierte Befehl verwendet das Cmdlet Get-SCOMGroup , um die Gruppe Alle Windows-Computer abzurufen, und speichert das Ergebnis in der variablen $WindowsComputers.
Der fünfte Befehl verwendet die Add-Methode mit der ID der variablen $WindowsComputers.
Der sechste Befehl verwendet die Update-Methode.
Beispiel 5: Hinzufügen eines Benachrichtigungsabonnements für einen bestimmten Monitor
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 $CriteriaIn diesem Beispiel wird ein neues Benachrichtigungsabonnement für alle kritischen Warnungen des Monitors mit dem Anzeigenamen ContosoMonitor hinzugefügt.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber , um Abonnenten abzurufen und das Ergebnis in der variablen $Subscriber zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen, und speichert das Ergebnis in der variablen $Channel.
Der dritte Befehl verwendet das Cmdlet Get-SCOMMonitor und speichert das Ergebnis in der variablen $Monitor.
Mit dem vierten Befehl werden die XML-Kriterien in der variablen $Criteria gespeichert.
Der fünfte Befehl verwendet das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber, Channel und Criteria .
Parameter
-BccSubscriber
Gibt ein Array von Abonnenten für blinde Kohlenstoffkopie (Blind Carbon Copy, BCC) für eine Nachricht für ein Abonnement an.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CcSubscriber
Gibt ein Array von Abonnenten für carbon copy (CC) für eine Nachricht für ein Abonnement an.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Channel
Gibt ein Array von Benachrichtigungskanälen an. Verwenden Sie zum Abrufen eines Benachrichtigungskanalobjekts das Cmdlet Get-SCOMNotificationChannel .
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
Gibt ein Array von Namen von Computern an. Das Cmdlet stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an.
Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Criteria
Gibt die Kriterien-XML an, die angibt, wie Warnungen für dieses Abonnement gefiltert werden. Kriterien können nach bestimmten Regeln oder Monitoren oder Eigenschaften der Warnung filtern, aber nicht nach Klassen oder Gruppen filtern.
Sie können die Kriterien-XML manuell aus einem vorhandenen Abonnement kopieren.
Verwenden Sie das folgende Modell, um die Kriterien-XML aus einem vorhandenen Abonnement abzurufen: $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
Gibt in HH:MM:SS eine Verzögerung für das Senden von Benachrichtigungen an, wenn die Bedingungen für diesen Zeitraum unverändert bleiben. Standardmäßig sendet Operations Manager Benachrichtigungen sofort.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für das Benachrichtigungsabonnement an. Wenn Sie keine Beschreibung angeben, wird der Parameter standardmäßig auf den Wert des DisplayName-Parameters festgelegt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Disabled
Gibt an, dass das Cmdlet ein Abonnement erstellt, es jedoch deaktiviert belässt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Gibt einen Anzeigenamen für das Abonnement an. Wenn Sie keine Beschreibung angeben, wird der Parameter standardmäßig auf den Wert des Parameters Name festgelegt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Gibt einen Namen für das Abonnement an.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OnlyOnResolutionChange
Gibt an, dass die Benachrichtigung nur erfolgt, wenn sich der Auflösungszustand der Warnung ändert.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PollingInterval
Gibt ein Abfrageintervall für Warnungen an. Wenn Sie diesen Parameter nicht angeben, wird das Intervall standardmäßig auf 1 Minute festgelegt.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Gibt ein Array von Connection-Objekten an. Verwenden Sie das Cmdlet Get-SCManagementGroupConnection, um ein Connection-Objekt abzurufen.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subscriber
Gibt ein Array von Abonnenten für dieses Abonnement an. Verwenden Sie das Cmdlet Get-SCOMNotificationSubscriber , um ein Benachrichtigungsabonnentobjekt abzurufen.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |