Add-SCOMNotificationSubscription
Hozzáad egy értesítési előfizetést.
Syntax
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
Az Add-SCOMNotificationSubscription parancsmag egy értesítési előfizetést ad hozzá a System Center – Operations Managerben.
Ebben a kiadásban nem támogatott a parancsmag az előfizetések hatókörkezeléséhez egy feltétel alapján, de ezt az eredményt Windows PowerShell keresztül érheti el közvetlenül az SCOM SDK-hoz való hozzáféréssel.
Példák
1. példa: Értesítési előfizetés hozzáadása
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
Ez a példa egy új értesítési előfizetést ad hozzá az összes riasztáshoz.
Az első parancs a Get-SCOMNotificationSubscriber parancsmagot használja az előfizetők lekéréséhez, és az eredményt a $Subscriber változóban tárolja.
A második parancs a Get-SCOMNotificationChannel parancsmagot használja az értesítési csatorna lekéréséhez, és az eredményt a $Channel változóban tárolja.
A harmadik parancs az Add-SCOMNotificationSubscription parancsmagot használja a Név, az Előfizető és a Csatorna paraméterekkel.
2. példa: Értesítési előfizetés hozzáadása feltételekkel
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
Ez a példa új értesítési előfizetést ad hozzá az összes riasztáshoz, de csak akkor értesíti, ha a feltételek 1 órán át változatlanok maradnak. A példa letiltott állapotban hozza létre az előfizetést.
Az első parancs a Get-SCOMNotificationSubscriber parancsmagot használja az előfizetők lekéréséhez, és az eredményt a $Subscriber változóban tárolja.
A második parancs a Get-SCOMNotificationChannel parancsmagot használja az értesítési csatorna lekéréséhez, és az eredményt a $Channel változóban tárolja.
A harmadik parancs az Add-SCOMNotificationSubscription parancsmagot használja a Név, az Előfizető és a Csatorna paraméterekkel.
3. példa: Új előfizetés hozzáadása egy adott osztály példányaihoz
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()
Ez a példa egy új értesítési előfizetést ad hozzá az összes riasztáshoz, majd az Operations Manager SDK-val hatókörbe helyezi az előfizetést a HealthService osztály példányai által létrehozott riasztásokra.
Az első parancs a Get-SCOMNotificationSubscriber parancsmagot használja az előfizetők lekéréséhez, és az eredményt a $Subscriber változóban tárolja.
A második parancs a Get-SCOMNotificationChannel parancsmagot használja az értesítési csatorna lekéréséhez, és az eredményt a $Channel változóban tárolja.
A harmadik parancs az Add-SCOMNotificationSubscription parancsmagot használja a Név, az Előfizető és a Csatorna paraméterekkel. A parancsmag az eredményt a $Subscription változóban tárolja.
A negyedik parancs a Get-SCOMClass parancsmagot használja, és az eredményt a $HealthService változóban tárolja.
Az ötödik parancs az Add metódust használja a $HealthService változó azonosítójával.
A hatodik parancs az Update metódust használja.
4. példa: Értesítési előfizetés hozzáadása az SDK használatával
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()
Ez a példa egy új értesítési előfizetést ad hozzá az összes riasztáshoz, majd az Operations Manager SDK-val hatókört biztosít az előfizetésnek a Minden Windows rendszerű számítógép csoport példányai által létrehozott riasztásokra.
Az első parancs a Get-SCOMNotificationSubscriber parancsmagot használja az előfizetők lekéréséhez, és az eredményt a $Subscriber változóban tárolja.
A második parancs a Get-SCOMNotificationChannel parancsmagot használja az értesítési csatorna lekéréséhez, és az eredményt a $Channel változóban tárolja.
A harmadik parancs az Add-SCOMNotificationSubscription parancsmagot használja a Név, az Előfizető és a Csatorna paraméterekkel. A parancsmag az eredményt a $Subscription változóban tárolja.
A negyedik parancs a Get-SCOMGroup parancsmagot használja a Minden Windows számítógép csoport lekéréséhez, és az eredményt a $WindowsComputers változóban tárolja.
Az ötödik parancs az Add metódust használja a $WindowsComputers változó azonosítójával.
A hatodik parancs az Update metódust használja.
5. példa: Értesítési előfizetés hozzáadása egy adott monitorhoz
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
Ez a példa egy új értesítési előfizetést ad hozzá a ContosoMonitor megjelenítendő figyelő által létrehozott összes kritikus riasztáshoz.
Az első parancs a Get-SCOMNotificationSubscriber parancsmagot használja az előfizetők lekéréséhez, és az eredményt a $Subscriber változóban tárolja.
A második parancs a Get-SCOMNotificationChannel parancsmagot használja az értesítési csatorna lekéréséhez, és az eredményt a $Channel változóban tárolja.
A harmadik parancs a Get-SCOMMonitor parancsmagot használja, és az eredményt a $Monitor változóban tárolja.
A negyedik parancs az XML-feltételeket a $Criteria változóban tárolja.
Az ötödik parancs az Add-SCOMNotificationSubscription parancsmagot használja a Név, az Előfizető, a Csatorna és a Feltétel paraméterekkel.
Paraméterek
-BccSubscriber
Olyan előfizetők tömbje, akik egy előfizetés üzenetén vak szén-dioxid-másolatot (BCC) használnak.
Type: | NotificationRecipient[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CcSubscriber
Egy előfizetés üzenetében a széndioxid-másolatra (CC) feliratkozók tömbjének megadása.
Type: | NotificationRecipient[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Channel
Az értesítési csatornák tömbje. Az értesítési csatorna objektumának beszerzéséhez használja a Get-SCOMNotificationChannel parancsmagot.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
A számítógépek nevének tömbje. A parancsmag ideiglenes kapcsolatokat hoz létre ezekhez a számítógépekhez tartozó felügyeleti csoportokkal. Használhat NetBIOS-neveket, IP-címeket vagy teljes tartományneveket (FQDN-eket). A helyi számítógép megadásához írja be a számítógép nevét, a localhost vagy a pont (.).
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Egy PSCredential objektumot ad meg a felügyeleti csoport kapcsolatához.
PSCredential objektum beszerzéséhez használja a Get-Credential parancsmagot.
További információért írja be a következőt: Get-Help Get-Credential
.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Criteria
Megadja az előfizetés riasztásainak szűrését jelző xml feltételt. A feltételek szűrhetnek a riasztás adott szabályaira vagy figyelőire vagy tulajdonságaira, de nem szűrhetnek osztályokra vagy csoportokra.
A feltétel xml-fájlját manuálisan másolhatja egy meglévő előfizetésből.
Ha egy meglévő előfizetésből szeretné beszerezni az XML feltételt, használja a következő modellt: $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
A HH:MM:SS-ben késleltetést ad az értesítések küldésére, ha a feltételek ebben az időszakban változatlanok maradnak. Alapértelmezés szerint az Operations Manager azonnal küld értesítéseket.
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Description
Megadja az értesítési előfizetés leírását. Ha nem ad meg leírást, a paraméter alapértelmezés szerint a DisplayName paraméter értéke lesz.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Disabled
Azt jelzi, hogy a parancsmag létrehoz egy előfizetést, de letiltott állapotban hagyja.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Az előfizetés megjelenítendő nevét adja meg. Ha nem ad meg leírást, a paraméter alapértelmezés szerint a Name paraméter értékét adja meg.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Megadja az előfizetés nevét.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OnlyOnResolutionChange
Azt jelzi, hogy az értesítés csak akkor fordul elő, ha a riasztás feloldási állapota megváltozik.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PollingInterval
Lekérdezési időközt ad meg a riasztásokhoz. Ha nem adja meg ezt a paramétert, az időköz alapértelmezés szerint 1 perc lesz.
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SCSession
Kapcsolatobjektumok tömbje. Kapcsolatobjektum beszerzéséhez használja a Get-SCManagementGroupConnection parancsmagot.
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Subscriber
Az előfizetés előfizetőinek tömbje. Értesítés-előfizetői objektum beszerzéséhez használja a Get-SCOMNotificationSubscriber parancsmagot.
Type: | NotificationRecipient[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |