Add-SCOMNotificationSubscription
Dodaje subskrypcję powiadomień.
Składnia
Default (Domyślna)
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 możesz osiągnąć ten wynik za pomocą programu Windows PowerShell, bezpośrednio korzystając z 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 $Channel
W 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 w celu pobrania kanału powiadomień i zapisuje wynik w zmiennej $Channel.
Trzecie polecenie używa polecenia cmdlet Add-SCOMNotificationSubscription z parametrami Name, Subscriberi 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" -Disabled
W tym przykładzie dodano nową subskrypcję powiadomień dla wszystkich alertów, ale powiadamia tylko o tym, czy warunki pozostają niezmienione przez 1 godzinę. W przykładzie tworzona jest 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 w celu pobrania kanału powiadomień i zapisuje wynik w zmiennej $Channel.
Trzecie polecenie używa polecenia cmdlet Add-SCOMNotificationSubscription z parametrami Name, Subscriberi 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 w celu pobrania kanału powiadomień i zapisuje wynik w zmiennej $Channel.
Trzecie polecenie używa polecenia cmdlet Add-SCOMNotificationSubscription z parametrami Name, Subscriberi 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 w celu pobrania kanału powiadomień i zapisuje wynik w zmiennej $Channel.
Trzecie polecenie używa polecenia cmdlet Add-SCOMNotificationSubscription z parametrami Name, Subscriberi Channel. Polecenie cmdlet przechowuje wynik w zmiennej $Subscription.
Czwarte polecenie używa polecenia cmdlet Get-SCOMGroup, aby uzyskać grupę 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 $Criteria
W tym przykładzie dodano nową subskrypcję powiadomień dla wszystkich alertów krytycznych zgłaszanych przez monitor o nazwie wyświetlanej 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 w celu 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, Channeli Criteria.
Parametry
-BccSubscriber
Określa tablicę subskrybentów do ślepej kopii dwutlenku węgla (BCC) w komunikacie dla subskrypcji.
Właściwości parametru
| Typ: | NotificationRecipient[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-CcSubscriber
Określa tablicę subskrybentów do kopiowania dwutlenku węgla (CC) w komunikacie dla subskrypcji.
Właściwości parametru
| Typ: | NotificationRecipient[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Channel
Określa tablicę kanałów powiadomień. Aby uzyskać obiekt kanału powiadomień, użyj polecenia cmdlet Get-SCOMNotificationChannel.
Właściwości parametru
| Typ: | Object[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | 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ę (.).
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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 Get-Help Get-Credential.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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ć klas ani 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.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 3 |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Delay
Określa opóźnienie, w HH:MM:SS, do wysyłania powiadomień, jeśli warunki pozostaną niezmienione w tym okresie. Domyślnie program Operations Manager wysyła powiadomienia natychmiast.
Właściwości parametru
| Typ: | TimeSpan |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Description
Określa opis subskrypcji powiadomień. Jeśli nie określisz opisu, parametr zostanie domyślnie ustawiony na wartość parametru DisplayName.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Disabled
Wskazuje, że polecenie cmdlet tworzy subskrypcję, ale pozostawia ją w stanie wyłączonym.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-DisplayName
Określa nazwę wyświetlaną subskrypcji. Jeśli nie określisz opisu, parametr zostanie domyślnie ustawiony na wartość parametru Name.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwę subskrypcji.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-OnlyOnResolutionChange
Wskazuje, że powiadomienie występuje tylko wtedy, gdy stan rozwiązania alertu ulegnie zmianie.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-PollingInterval
Określa interwał sondowania alertów. Jeśli nie określisz tego parametru, interwał zostanie domyślnie ustawiony na 1 minutę.
Właściwości parametru
| Typ: | TimeSpan |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-SCSession
Określa tablicę obiektów połączenia
Właściwości parametru
| Typ: | Connection[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Subscriber
Określa tablicę subskrybentów dla tej subskrypcji. Aby uzyskać obiekt subskrybenta powiadomień, użyj polecenia cmdlet Get-SCOMNotificationSubscriber.
Właściwości parametru
| Typ: | NotificationRecipient[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.