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 Add-SCOMNotificationSubscription-Cmdlet fügt ein Benachrichtigungsabonnement in System Center 2019 – Operations Manager hinzu.
In dieser Version gibt es keine Cmdlet-Unterstützung für Scoping-Abonnements basierend auf einem Kriterium, aber Sie können dieses Ergebnis über 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 $Channel
In diesem Beispiel wird für alle Warnungen ein neues Benachrichtigungsabonnement hinzugefügt.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber , um Abonnenten abzurufen und das Ergebnis in der $Subscriber Variablen zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen und das Ergebnis in der $Channel Variablen zu speichern.
Der dritte Befehl verwendet das Add-SCOMNotificationSubscription-Cmdlet 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" -Disabled
In diesem Beispiel wird für alle Warnungen ein neues Benachrichtigungsabonnement hinzugefügt, aber nur benachrichtigt, wenn die Bedingungen für 1 Stunde 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 $Subscriber Variablen zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen und das Ergebnis in der $Channel Variablen zu speichern.
Der dritte Befehl verwendet das Add-SCOMNotificationSubscription-Cmdlet 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. Anschließend wird das Operations Manager SDK verwendet, um das Abonnement auf Warnungen zu beschränken, die von Instanzen der HealthService-Klasse ausgelöst wurden.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber , um Abonnenten abzurufen und das Ergebnis in der $Subscriber Variablen zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen und das Ergebnis in der $Channel Variablen zu speichern.
Der dritte Befehl verwendet das Add-SCOMNotificationSubscription-Cmdlet mit den Parametern Name, Subscriber und Channel . Das Cmdlet speichert das Ergebnis in der $Subscription Variablen.
Der vierte Befehl verwendet das Cmdlet Get-SCOMClass und speichert das Ergebnis in der $HealthService Variablen.
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 zu beschränken, die von Instanzen in der Gruppe "Alle Windows-Computer" ausgelöst wurden.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber , um Abonnenten abzurufen und das Ergebnis in der $Subscriber Variablen zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen und das Ergebnis in der $Channel Variablen zu speichern.
Der dritte Befehl verwendet das Add-SCOMNotificationSubscription-Cmdlet mit den Parametern Name, Subscriber und Channel . Das Cmdlet speichert das Ergebnis in der $Subscription Variablen.
Der vierte Befehl verwendet das Cmdlet Get-SCOMGroup , um die Gruppe "Alle Windows-Computer" abzurufen und das Ergebnis in der $WindowsComputers Variablen zu speichern.
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 $Criteria
In diesem Beispiel wird ein neues Benachrichtigungsabonnement für alle kritischen Warnungen hinzugefügt, die vom Monitor mit dem Anzeigenamen ContosoMonitor ausgelöst werden.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber , um Abonnenten abzurufen und das Ergebnis in der $Subscriber Variablen zu speichern.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel , um den Benachrichtigungskanal abzurufen und das Ergebnis in der $Channel Variablen zu speichern.
Der dritte Befehl verwendet das Cmdlet Get-SCOMMonitor und speichert das Ergebnis in der $Monitor Variablen.
Der vierte Befehl speichert die XML-Kriterien in der $Criteria Variablen.
Der fünfte Befehl verwendet das Add-SCOMNotificationSubscription-Cmdlet mit den Parametern Name, Subscriber, Channel und Criteria .
Parameter
-BccSubscriber
Gibt ein Array von Abonnenten für blinde 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 an, die auf einer Nachricht für ein Abonnement (Carbon Copy, CC) gespeichert sind.
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. Um den lokalen Computer anzugeben, geben Sie 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.
Um die Kriterien-XML aus einem vorhandenen Abonnement abzurufen, verwenden Sie dieses Modell: $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 eine Verzögerung in HH:MM:SS für das Senden von Benachrichtigungen an, wenn die Bedingungen für diesen Zeitraum unverändert bleiben. Der Operations Manager sendet standardmäßig sofort Benachrichtigungen.
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 aber in einem deaktivierten Zustand verlä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 Namensparameters 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 auftritt, 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 zum Abrufen eines Connection-Objekts das Cmdlet Get-SCManagementGroupConnection.
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 zum Abrufen eines Benachrichtigungsabonnentobjekts das Cmdlet Get-SCOMNotificationSubscriber .
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 |