Condividi tramite

Add-SCOMNotificationSubscription

  • Riferimento
Modulo:
OperationsManager

Aggiunge una sottoscrizione di notifica.

Sintassi

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>]

Descrizione

Il cmdlet Add-SCOMNotificationSubscription aggiunge una sottoscrizione di notifica in System Center Operations Manager.

In questa versione non è disponibile alcun supporto per i cmdlet per la definizione dell'ambito delle sottoscrizioni in base a criteri, ma è possibile ottenere questo risultato tramite Windows PowerShell accedendo direttamente a SCOM SDK.

Esempio

Esempio 1: Aggiungere una sottoscrizione di notifica

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

In questo esempio viene aggiunta una nuova sottoscrizione di notifica per tutti gli avvisi.

Il primo comando usa il cmdlet Get-SCOMNotificationSubscriber per ottenere sottoscrittori e archivia il risultato nella variabile $Subscriber.

Il secondo comando usa il cmdlet Get-SCOMNotificationChannel per ottenere il canale di notifica e archivia il risultato nella variabile $Channel.

Il terzo comando usa il cmdlet Add-SCOMNotificationSubscription con i parametri Name, Subscriber e Channel .

Esempio 2: Aggiungere una sottoscrizione di notifica con condizioni

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

In questo esempio viene aggiunta una nuova sottoscrizione di notifica per tutti gli avvisi, ma viene inviata una notifica solo se le condizioni rimangono invariate per 1 ora. Nell'esempio viene creata la sottoscrizione nello stato disabilitato.

Il primo comando usa il cmdlet Get-SCOMNotificationSubscriber per ottenere sottoscrittori e archivia il risultato nella variabile $Subscriber.

Il secondo comando usa il cmdlet Get-SCOMNotificationChannel per ottenere il canale di notifica e archivia il risultato nella variabile $Channel.

Il terzo comando usa il cmdlet Add-SCOMNotificationSubscription con i parametri Name, Subscriber e Channel .

Esempio 3: Aggiungere una nuova sottoscrizione per le istanze di una classe specifica

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()

In questo esempio viene aggiunta una nuova sottoscrizione di notifica per tutti gli avvisi, quindi viene usato Operations Manager SDK per definire l'ambito della sottoscrizione agli avvisi generati dalle istanze della classe HealthService.

Il primo comando usa il cmdlet Get-SCOMNotificationSubscriber per ottenere sottoscrittori e archivia il risultato nella variabile $Subscriber.

Il secondo comando usa il cmdlet Get-SCOMNotificationChannel per ottenere il canale di notifica e archivia il risultato nella variabile $Channel.

Il terzo comando usa il cmdlet Add-SCOMNotificationSubscription con i parametri Name, Subscriber e Channel . Il cmdlet archivia il risultato nella variabile $Subscription.

Il quarto comando usa il cmdlet Get-SCOMClass e archivia il risultato nella variabile $HealthService.

Il quinto comando usa il metodo Add con l'ID della variabile $HealthService.

Il sesto comando usa il metodo Update.

Esempio 4: Aggiungere una sottoscrizione di notifica usando l'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()

Questo esempio aggiunge una nuova sottoscrizione di notifica per tutti gli avvisi e quindi usa Operations Manager SDK per definire l'ambito della sottoscrizione agli avvisi generati dalle istanze nel gruppo Tutti i computer Windows.

Il primo comando usa il cmdlet Get-SCOMNotificationSubscriber per ottenere sottoscrittori e archivia il risultato nella variabile $Subscriber.

Il secondo comando usa il cmdlet Get-SCOMNotificationChannel per ottenere il canale di notifica e archivia il risultato nella variabile $Channel.

Il terzo comando usa il cmdlet Add-SCOMNotificationSubscription con i parametri Name, Subscriber e Channel . Il cmdlet archivia il risultato nella variabile $Subscription.

Il quarto comando usa il cmdlet Get-SCOMGroup per ottenere il gruppo Tutti i computer Windows e archivia il risultato nella variabile $WindowsComputers.

Il quinto comando usa il metodo Add con l'ID della variabile $WindowsComputers.

Il sesto comando usa il metodo Update.

Esempio 5: Aggiungere una sottoscrizione di notifica per un monitoraggio specifico

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

In questo esempio viene aggiunta una nuova sottoscrizione di notifica per tutti gli avvisi critici generati dal monitoraggio con il nome visualizzato ContosoMonitor.

Il primo comando usa il cmdlet Get-SCOMNotificationSubscriber per ottenere sottoscrittori e archivia il risultato nella variabile $Subscriber.

Il secondo comando usa il cmdlet Get-SCOMNotificationChannel per ottenere il canale di notifica e archivia il risultato nella variabile $Channel.

Il terzo comando usa il cmdlet Get-SCOMMonitor e archivia il risultato nella variabile $Monitor.

Il quarto comando archivia i criteri XML nella variabile $Criteria.

Il quinto comando usa il cmdlet Add-SCOMNotificationSubscription con i parametri Name, Subscriber, Channel e Criteria .

Parametri

-BccSubscriber

Specifica una matrice di sottoscrittori per la copia di carbonio non cieco (BCC) in un messaggio per una sottoscrizione.

Type:NotificationRecipient[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CcSubscriber

Specifica una matrice di sottoscrittori per la copia a carbonio (CC) in un messaggio per una sottoscrizione.

Type:NotificationRecipient[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Channel

Specifica una matrice di canali di notifica. Per ottenere un oggetto canale di notifica, usare il cmdlet Get-SCOMNotificationChannel .

Type:Object[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Specifica una matrice di nomi di computer. Il cmdlet stabilisce connessioni temporanee con i gruppi di gestione per questi computer. È possibile usare nomi NetBIOS, indirizzi IP o nomi di dominio completi (FQDN). Per specificare il computer locale, digitare il nome del computer, localhost o un punto (.).

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifica un oggetto PSCredential per la connessione al gruppo di gestione. Per ottenere un oggetto PSCredential, usare il cmdlet Get-Credential. Per ulteriori informazioni, digitare Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Criteria

Specifica il file XML dei criteri che indica come filtrare gli avvisi per questa sottoscrizione. I criteri possono filtrare in base a determinate regole o monitoraggi o proprietà dell'avviso, ma non possono filtrare in base a classi o gruppi.

È possibile copiare manualmente il file XML dei criteri da una sottoscrizione esistente. Per ottenere il file XML dei criteri da una sottoscrizione esistente, usare questo modello: $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

Specifica un ritardo, in HH:MM:SS, per l'invio di notifiche se le condizioni rimangono invariate per questo periodo di tempo. Per impostazione predefinita, Operations Manager invia immediatamente le notifiche.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Description

Specifica una descrizione per la sottoscrizione di notifica. Se non si specifica una descrizione, per impostazione predefinita il parametro viene impostato sul valore del parametro DisplayName .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Disabled

Indica che il cmdlet crea una sottoscrizione ma la lascia in uno stato disabilitato.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Specifica un nome visualizzato per la sottoscrizione. Se non si specifica una descrizione, il parametro viene impostato per impostazione predefinita sul valore del parametro Name .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifica un nome per la sottoscrizione.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OnlyOnResolutionChange

Indica che la notifica viene eseguita solo quando cambia lo stato di risoluzione dell'avviso.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PollingInterval

Specifica un intervallo di polling per gli avvisi. Se questo parametro non viene specificato, per impostazione predefinita l'intervallo è 1 minuto.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

Specifica una matrice di oggetti Connection . Per ottenere un oggetto Connection , utilizzare il cmdlet Get-SCManagementGroupConnection .

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Subscriber

Specifica una matrice di sottoscrittori per questa sottoscrizione. Per ottenere un oggetto sottoscrittore di notifica, usare il cmdlet Get-SCOMNotificationSubscriber .

Type:NotificationRecipient[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False