Add-SCOMNotificationSubscription
Fügt ein Benachrichtigungsabonnement hinzu.
Syntax
Default (Standardwert)
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
Mit dem Cmdlet Add-SCOMNotificationSubscription wird ein Benachrichtigungsabonnement in System Center – Operations Manager hinzugefügt.
In dieser Version gibt es keine Cmdlet-Unterstützung für das Festlegen des Bereichs von Abonnements auf der Grundlage eines Kriteriums, aber Sie können dieses Ergebnis über Windows PowerShell erzielen, 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 ein neues Benachrichtigungsabonnement für alle Warnungen hinzugefügt.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber zum Abrufen von Abonnenten und speichert das Ergebnis in der Variablen $Subscriber.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel zum Abrufen des Benachrichtigungskanals und speichert das Ergebnis in der Variablen $Channel.
Im dritten Befehl wird das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber und Channel verwendet.
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 ein neues Benachrichtigungsabonnement für alle Warnungen hinzugefügt, es wird jedoch 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 zum Abrufen von Abonnenten und speichert das Ergebnis in der Variablen $Subscriber.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel zum Abrufen des Benachrichtigungskanals und speichert das Ergebnis in der Variablen $Channel.
Im dritten Befehl wird das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber und Channel verwendet.
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 dann wird das Operations Manager SDK verwendet, um das Abonnement auf Warnungen zu beschränken, die von Instanzen der HealthService-Klasse ausgelöst werden.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber zum Abrufen von Abonnenten und speichert das Ergebnis in der Variablen $Subscriber.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel zum Abrufen des Benachrichtigungskanals und speichert das Ergebnis in der Variablen $Channel.
Im dritten Befehl wird das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber und Channel verwendet. 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 dann 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 werden.
Der erste Befehl verwendet das Cmdlet Get-SCOMNotificationSubscriber zum Abrufen von Abonnenten und speichert das Ergebnis in der Variablen $Subscriber.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel zum Abrufen des Benachrichtigungskanals und speichert das Ergebnis in der Variablen $Channel.
Im dritten Befehl wird das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber und Channel verwendet. Das Cmdlet speichert das Ergebnis in der Variablen $Subscription.
Der vierte Befehl verwendet das Cmdlet Get-SCOMGroup zum Abrufen der Gruppe Alle Windows-Computer 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 $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 zum Abrufen von Abonnenten und speichert das Ergebnis in der Variablen $Subscriber.
Der zweite Befehl verwendet das Cmdlet Get-SCOMNotificationChannel zum Abrufen des Benachrichtigungskanals und speichert das Ergebnis in der Variablen $Channel.
Der dritte Befehl verwendet das Cmdlet Get-SCOMMonitor und speichert das Ergebnis in der Variablen $Monitor.
Der vierte Befehl speichert die XML-Kriterien in der Variablen $Criteria.
Im fünften Befehl wird das Cmdlet Add-SCOMNotificationSubscription mit den Parametern Name, Subscriber, Channel und Criteria verwendet.
Parameter
-BccSubscriber
Gibt ein Array von Abonnenten für Blind Carbon Copy (BCC) in einer Nachricht für ein Abonnement an.
Parametereigenschaften
| Typ: | NotificationRecipient[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-CcSubscriber
Gibt ein Array von Abonnenten für Carbon Copy (CC) in einer Nachricht für ein Abonnement an.
Parametereigenschaften
| Typ: | NotificationRecipient[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Channel
Gibt ein Array von Benachrichtigungskanälen an. Verwenden Sie zum Abrufen eines Benachrichtigungskanalobjekts das Cmdlet Get-SCOMNotificationChannel .
Parametereigenschaften
| Typ: | Object[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | 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 (Fully Qualified Domain Names, FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den Localhost oder einen Punkt (.) ein.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt ein PSCredential- -Objekt für die Verwaltungsgruppenverbindung an.
Verwenden Sie das Cmdlet Get-Credential, um ein PSCredential-Objekt abzurufen.
Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Criteria
Gibt die XML-Kriteriendatei an, die angibt, wie Warnungen für dieses Abonnement gefiltert werden. Kriterien können nach bestimmten Regeln oder Monitoren oder Eigenschaften der Warnung filtern, jedoch nicht nach Klassen oder Gruppen.
Sie können die Kriterien-XML manuell aus einem vorhandenen Abonnement kopieren.
Verwenden Sie dieses Modell, um die Kriterien-XML aus einem vorhandenen Abonnement abzurufen: $subscription = Get-SCOMNotificationSubscription | Select-Object -First 1 $criteria = $subscription.Configuration.Criteria.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 3 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | 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 sofort Benachrichtigungen.
Parametereigenschaften
| Typ: | TimeSpan |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Description
Gibt eine Beschreibung für das Benachrichtigungsabonnement an. Wenn Sie keine Beschreibung angeben, wird der Parameter standardmäßig auf den Wert des Parameters DisplayName gesetzt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Disabled
Gibt an, dass das Cmdlet ein Abonnement erstellt, es jedoch im deaktivierten Zustand belässt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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 gesetzt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt einen Namen für das Abonnement an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-OnlyOnResolutionChange
Gibt an, dass die Benachrichtigung nur erfolgt, wenn sich der Auflösungsstatus der Warnung ändert.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-PollingInterval
Gibt ein Abrufintervall für Warnungen an. Wenn Sie diesen Parameter nicht angeben, beträgt das Intervall standardmäßig 1 Minute.
Parametereigenschaften
| Typ: | TimeSpan |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-SCSession
Gibt ein Array von Connection-Objekten an. Um ein Connection-Objekt abzurufen, verwenden Sie das cmdlet Get-SCManagementGroupConnection.
Parametereigenschaften
| Typ: | Connection[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Subscriber
Gibt ein Array von Abonnenten für dieses Abonnement an. Verwenden Sie zum Abrufen eines Benachrichtigungsabonnentenobjekts das Cmdlet Get-SCOMNotificationSubscriber .
Parametereigenschaften
| Typ: | NotificationRecipient[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.