Add-SCOMNotificationSubscription
Dodaje subskrypcję powiadomień.
Składnia
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>] Opis
Polecenie cmdlet Add-SCOMNotificationSubscription dodaje subskrypcję powiadomień w programie System Center — Operations Manager.
W tej wersji nie ma obsługi poleceń cmdlet do określania zakresu subskrypcji na podstawie kryteriów, ale ten wynik można osiągnąć za pomocą Windows PowerShell przez bezpośredni dostęp do zestawu SCOM SDK.
Przykłady
Przykład 1. Dodawanie subskrypcji powiadomień
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 $ChannelW tym przykładzie dodano nową subskrypcję powiadomień dla wszystkich alertów.
Pierwsze polecenie używa polecenia cmdlet Get-SCOMNotificationSubscriber , aby pobrać subskrybentów i zapisać wynik w zmiennej $Subscriber.
Drugie polecenie używa polecenia cmdlet Get-SCOMNotificationChannel do pobrania kanału powiadomień i zapisuje wynik w zmiennej $Channel.
Trzecie polecenie używa polecenia cmdlet Add-SCOMNotificationSubscription z parametrami Name, Subscriber i Channel .
Przykład 2: Dodawanie subskrypcji powiadomień z warunkami
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" -DisabledW tym przykładzie dodano nową subskrypcję powiadomień dla wszystkich alertów, ale powiadamia tylko wtedy, gdy warunki pozostaną niezmienione przez 1 godzinę. W przykładzie jest tworzona subskrypcja w stanie wyłączonym.
Pierwsze polecenie używa polecenia cmdlet Get-SCOMNotificationSubscriber , aby pobrać subskrybentów i zapisać wynik w zmiennej $Subscriber.
Drugie polecenie używa polecenia cmdlet Get-SCOMNotificationChannel do pobrania kanału powiadomień i zapisuje wynik w zmiennej $Channel.
Trzecie polecenie używa polecenia cmdlet Add-SCOMNotificationSubscription z parametrami Name, Subscriber i Channel .
Przykład 3. Dodawanie nowej subskrypcji dla wystąpień określonej klasy
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()W tym przykładzie dodano nową subskrypcję powiadomień dla wszystkich alertów, a następnie używa zestawu SDK programu Operations Manager do zakresu subskrypcji do alertów zgłaszanych przez wystąpienia klasy HealthService.
Pierwsze polecenie używa polecenia cmdlet Get-SCOMNotificationSubscriber , aby pobrać subskrybentów i zapisać wynik w zmiennej $Subscriber.
Drugie polecenie używa polecenia cmdlet Get-SCOMNotificationChannel do pobrania kanału powiadomień i zapisuje wynik w zmiennej $Channel.
Trzecie polecenie używa polecenia cmdlet Add-SCOMNotificationSubscription z parametrami Name, Subscriber i Channel . Polecenie cmdlet przechowuje wynik w zmiennej $Subscription.
Czwarte polecenie używa polecenia cmdlet Get-SCOMClass i zapisuje wynik w zmiennej $HealthService.
Piąte polecenie używa metody Add z identyfikatorem zmiennej $HealthService.
Szóste polecenie używa metody Update.
Przykład 4. Dodawanie subskrypcji powiadomień przy użyciu zestawu 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()W tym przykładzie dodano nową subskrypcję powiadomień dla wszystkich alertów, a następnie używa zestawu SDK programu Operations Manager do zakresu subskrypcji do alertów zgłaszanych przez wystąpienia w grupie Wszystkie komputery z systemem Windows.
Pierwsze polecenie używa polecenia cmdlet Get-SCOMNotificationSubscriber , aby pobrać subskrybentów i zapisać wynik w zmiennej $Subscriber.
Drugie polecenie używa polecenia cmdlet Get-SCOMNotificationChannel do pobrania kanału powiadomień i zapisuje wynik w zmiennej $Channel.
Trzecie polecenie używa polecenia cmdlet Add-SCOMNotificationSubscription z parametrami Name, Subscriber i Channel . Polecenie cmdlet przechowuje wynik w zmiennej $Subscription.
Czwarte polecenie używa polecenia cmdlet Get-SCOMGroup do pobrania grupy Wszystkie komputery z systemem Windows i zapisuje wynik w zmiennej $WindowsComputers.
Piąte polecenie używa metody Add z identyfikatorem zmiennej $WindowsComputers.
Szóste polecenie używa metody Update.
Przykład 5. Dodawanie subskrypcji powiadomień dla określonego monitora
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 $CriteriaW tym przykładzie dodano nową subskrypcję powiadomień dla wszystkich alertów krytycznych zgłaszanych przez monitor, który ma nazwę wyświetlaną ContosoMonitor.
Pierwsze polecenie używa polecenia cmdlet Get-SCOMNotificationSubscriber , aby pobrać subskrybentów i zapisać wynik w zmiennej $Subscriber.
Drugie polecenie używa polecenia cmdlet Get-SCOMNotificationChannel do pobrania kanału powiadomień i zapisuje wynik w zmiennej $Channel.
Trzecie polecenie używa polecenia cmdlet Get-SCOMMonitor i zapisuje wynik w zmiennej $Monitor.
Czwarte polecenie przechowuje kryteria XML w zmiennej $Criteria.
Piąte polecenie używa polecenia cmdlet Add-SCOMNotificationSubscription z parametrami Name, Subscriber, Channel i Criteria .
Parametry
-BccSubscriber
Określa tablicę subskrybentów ślepej kopii dwutlenku węgla (BCC) w komunikacie dla subskrypcji.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CcSubscriber
Określa tablicę subskrybentów do kopiowania węgla (CC) w komunikacie dla subskrypcji.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Channel
Określa tablicę kanałów powiadomień. Aby uzyskać obiekt kanału powiadomień, użyj polecenia cmdlet Get-SCOMNotificationChannel .
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
Określa tablicę nazw komputerów. Polecenie cmdlet ustanawia tymczasowe połączenia z grupami zarządzania dla tych komputerów. Można użyć nazw NetBIOS, adresów IP lub w pełni kwalifikowanych nazw domen (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, localhost lub kropkę (.).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Określa obiekt PSCredential dla połączenia grupy zarządzania.
Aby uzyskać obiekt PSCredential , użyj polecenia cmdlet Get-Credential .
Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Criteria
Określa plik XML kryteriów wskazujący sposób filtrowania alertów dla tej subskrypcji. Kryteria mogą filtrować według określonych reguł lub monitorów lub właściwości alertu, ale nie mogą filtrować według klas lub grup.
Możesz ręcznie skopiować plik XML kryteriów z istniejącej subskrypcji.
Aby uzyskać plik XML kryteriów z istniejącej subskrypcji, użyj tego modelu: $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
Określa opóźnienie, w HH:MM:SS, do wysyłania powiadomień, jeśli warunki pozostaną niezmienione przez ten okres czasu. Domyślnie program Operations Manager wysyła powiadomienia natychmiast.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
Określa opis subskrypcji powiadomień. Jeśli nie określisz opisu, parametr zostanie domyślnie ustawiony na wartość parametru DisplayName .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Disabled
Wskazuje, że polecenie cmdlet tworzy subskrypcję, ale pozostawia ją w stanie wyłączonym.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Określa nazwę wyświetlaną subskrypcji. Jeśli nie określisz opisu, parametr zostanie domyślnie ustawiony na wartość parametru Name .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Określa nazwę subskrypcji.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OnlyOnResolutionChange
Wskazuje, że powiadomienie ma miejsce tylko wtedy, gdy zmieni się stan rozwiązania alertu.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PollingInterval
Określa interwał sondowania dla alertów. Jeśli ten parametr nie zostanie określony, interwał będzie domyślnie ustawiony na 1 minutę.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Określa tablicę obiektów Połączenia . Aby uzyskać obiekt Connection , użyj polecenia cmdlet Get-SCManagementGroupConnection .
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subscriber
Określa tablicę subskrybentów dla tej subskrypcji. Aby uzyskać obiekt subskrybenta powiadomień, użyj polecenia cmdlet Get-SCOMNotificationSubscriber .
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |