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 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 $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 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" -DisabledW 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 $CriteriaW 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.
| Typ: | NotificationRecipient[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-CcSubscriber
Określa tablicę subskrybentów do kopiowania dwutlenku węgla (CC) w komunikacie dla subskrypcji.
| Typ: | NotificationRecipient[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Channel
Określa tablicę kanałów powiadomień. Aby uzyskać obiekt kanału powiadomień, użyj polecenia cmdlet Get-SCOMNotificationChannel.
| Typ: | Object[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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ę (.).
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | PSCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | 3 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | TimeSpan |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Description
Określa opis subskrypcji powiadomień. Jeśli nie określisz opisu, parametr zostanie domyślnie ustawiony na wartość parametru DisplayName.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Disabled
Wskazuje, że polecenie cmdlet tworzy subskrypcję, ale pozostawia ją w stanie wyłączonym.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DisplayName
Określa nazwę wyświetlaną subskrypcji. Jeśli nie określisz opisu, parametr zostanie domyślnie ustawiony na wartość parametru Name.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Określa nazwę subskrypcji.
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-OnlyOnResolutionChange
Wskazuje, że powiadomienie występuje tylko wtedy, gdy stan rozwiązania alertu ulegnie zmianie.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-PollingInterval
Określa interwał sondowania alertów. Jeśli nie określisz tego parametru, interwał zostanie domyślnie ustawiony na 1 minutę.
| Typ: | TimeSpan |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-SCSession
Określa tablicę obiektów połączenia
| Typ: | Connection[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Subscriber
Określa tablicę subskrybentów dla tej subskrypcji. Aby uzyskać obiekt subskrybenta powiadomień, użyj polecenia cmdlet Get-SCOMNotificationSubscriber.
| Typ: | NotificationRecipient[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |