Add-SCOMNotificationSubscription
Přidá odběr oznámení.
Syntaxe
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>]
Description
Rutina Add-SCOMNotificationSubscription přidá odběr oznámení v nástroji System Center – Operations Manager.
V této verzi neexistuje žádná podpora pro nastavení rozsahu předplatných na základě kritérií, ale tento výsledek můžete dosáhnout prostřednictvím Windows PowerShellu tak, že se k sadě SDK SCOM dostanete přímo.
Příklady
Příklad 1: Přidání odběru oznámení
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
Tento příklad přidá nové odběr oznámení pro všechna upozornění.
První příkaz používá rutinu Get-SCOMNotificationSubscriber k získání odběratelů a uložení výsledku do proměnné $Subscriber.
Druhý příkaz používá rutinu Get-SCOMNotificationChannel k získání kanálu oznámení a uloží výsledek do proměnné $Channel.
Třetí příkaz používá rutinu Add-SCOMNotificationSubscription s parametry Name, Subscribera Channel.
Příklad 2: Přidání odběru oznámení s podmínkami
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
Tento příklad přidá nové odběr oznámení pro všechna upozornění, ale upozorní pouze v případě, že podmínky zůstanou beze změny po dobu 1 hodiny. V příkladu se vytvoří předplatné v zakázaném stavu.
První příkaz používá rutinu Get-SCOMNotificationSubscriber k získání odběratelů a uložení výsledku do proměnné $Subscriber.
Druhý příkaz používá rutinu Get-SCOMNotificationChannel k získání kanálu oznámení a uloží výsledek do proměnné $Channel.
Třetí příkaz používá rutinu Add-SCOMNotificationSubscription s parametry Name, Subscribera Channel.
Příklad 3: Přidání nového předplatného pro instance konkrétní třídy
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()
Tento příklad přidá nové odběr oznámení pro všechna upozornění a pak pomocí sady SDK nástroje Operations Manager nastaví rozsah předplatného na výstrahy vyvolané instancemi třídy HealthService.
První příkaz používá rutinu Get-SCOMNotificationSubscriber k získání odběratelů a uložení výsledku do proměnné $Subscriber.
Druhý příkaz používá rutinu Get-SCOMNotificationChannel k získání kanálu oznámení a uloží výsledek do proměnné $Channel.
Třetí příkaz používá rutinu Add-SCOMNotificationSubscription s parametry Name, Subscribera Channel. Rutina uloží výsledek do proměnné $Subscription.
Čtvrtý příkaz používá rutinu Get-SCOMClass a uloží výsledek do proměnné $HealthService.
Pátý příkaz používá metodu Add s ID proměnné $HealthService.
Šestý příkaz používá metodu Update.
Příklad 4: Přidání odběru oznámení pomocí sady 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()
Tento příklad přidá nové odběr oznámení pro všechny výstrahy a pak pomocí sady SDK nástroje Operations Manager nastaví obor předplatného na výstrahy vyvolané instancemi ve skupině Všechny počítače se systémem Windows.
První příkaz používá rutinu Get-SCOMNotificationSubscriber k získání odběratelů a uložení výsledku do proměnné $Subscriber.
Druhý příkaz používá rutinu Get-SCOMNotificationChannel k získání kanálu oznámení a uloží výsledek do proměnné $Channel.
Třetí příkaz používá rutinu Add-SCOMNotificationSubscription s parametry Name, Subscribera Channel. Rutina uloží výsledek do proměnné $Subscription.
Čtvrtý příkaz používá rutinu Get-SCOMGroup k získání skupiny Všechny počítače se systémem Windows a uloží výsledek do proměnné $WindowsComputers.
Pátý příkaz používá metodu Add s ID $WindowsComputers proměnné.
Šestý příkaz používá metodu Update.
Příklad 5: Přidání odběru oznámení pro konkrétní monitorování
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
Tento příklad přidá nové odběr oznámení pro všechna kritická upozornění vyvolaná monitorováním, které má zobrazovaný název ContosoMonitor.
První příkaz používá rutinu Get-SCOMNotificationSubscriber k získání odběratelů a uložení výsledku do proměnné $Subscriber.
Druhý příkaz používá rutinu Get-SCOMNotificationChannel k získání kanálu oznámení a uloží výsledek do proměnné $Channel.
Třetí příkaz používá rutinu Get-SCOMMonitor a uloží výsledek do proměnné $Monitor.
Čtvrtý příkaz uloží kritéria XML do proměnné $Criteria.
Pátý příkaz používá rutinu
Parametry
-BccSubscriber
Určuje pole odběratelů pro skrytou kopii (BCC) ve zprávě pro odběr.
Typ: | NotificationRecipient[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-CcSubscriber
Určuje pole odběratelů kopie uhlíku (CC) ve zprávě pro odběr.
Typ: | NotificationRecipient[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Channel
Určuje pole kanálů oznámení. K získání objektu kanálu oznámení použijte rutinu Get-SCOMNotificationChannel.
Typ: | Object[] |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ComputerName
Určuje pole názvů počítačů. Rutina vytvoří dočasná připojení ke skupinám pro správu pro tyto počítače. Můžete použít názvy NetBIOS, IP adresy nebo plně kvalifikované názvy domén (FQDN). Chcete-li zadat místní počítač, zadejte název počítače, localhost nebo tečku (.).
Typ: | String[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Credential
Určuje objekt PSCredential pro připojení skupiny pro správu.
K získání objektu PSCredential použijte rutinu Get-Credential.
Další informace potřebujete zadáním Get-Help Get-Credential
.
Typ: | PSCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Criteria
Určuje xml kritérií, která označují, jak filtrovat výstrahy pro toto předplatné. Kritéria můžou filtrovat podle konkrétních pravidel nebo monitorů nebo vlastností výstrahy, ale nemůžou filtrovat podle tříd nebo skupin.
Z existujícího předplatného můžete ručně zkopírovat xml kritérií.
Chcete-li získat xml kritérií z existujícího předplatného, použijte tento model: $subscription = Get-SCOMNotificationSubscription | Select-Object -First 1 $criteria = $subscription.Configuration.Criteria
.
Typ: | String |
Position: | 3 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Delay
Určuje zpoždění v HH:MM:SS pro odesílání oznámení, pokud podmínky po tuto dobu zůstanou beze změny. Operations Manager ve výchozím nastavení odesílá oznámení okamžitě.
Typ: | TimeSpan |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Description
Určuje popis odběru oznámení. Pokud nezadáte popis, parametr se ve výchozím nastavení nastaví na hodnotu parametru DisplayName.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Disabled
Označuje, že rutina vytvoří předplatné, ale ponechá ho v zakázaném stavu.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DisplayName
Určuje zobrazovaný název předplatného. Pokud nezadáte popis, parametr se ve výchozím nastavení nastaví na hodnotu parametru Name.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Name
Určuje název předplatného.
Typ: | String |
Position: | 1 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-OnlyOnResolutionChange
Označuje, že k oznámení dochází pouze v případě, že se změní stav řešení výstrahy.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-PollingInterval
Určuje interval dotazování pro výstrahy. Pokud tento parametr nezadáte, výchozí interval je 1 minuta.
Typ: | TimeSpan |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-SCSession
Určuje pole objektů Connection. K získání objektu Connection použijte rutinu Get-SCManagementGroupConnection.
Typ: | Connection[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Subscriber
Určuje pole odběratelů pro toto předplatné. K získání objektu odběratele oznámení použijte rutinu Get-SCOMNotificationSubscriber.
Typ: | NotificationRecipient[] |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |