Add-SCOMNotificationSubscription
Agrega una suscripción de notificación.
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
El cmdlet Add-SCOMNotificationSubscription agrega una suscripción de notificación en System Center - Operations Manager.
En esta versión no hay compatibilidad con cmdlets para determinar el ámbito de las suscripciones en función de un criterio, pero puede lograr este resultado a través de Windows PowerShell accediendo directamente al SDK de SCOM.
Ejemplos
Ejemplo 1: Agregar una suscripción de notificación
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 $ChannelEn este ejemplo se agrega una nueva suscripción de notificación para todas las alertas.
El primer comando usa el cmdlet Get-SCOMNotificationSubscriber para obtener suscriptores y almacena el resultado en la variable $Subscriber.
El segundo comando usa el cmdlet Get-SCOMNotificationChannel para obtener el canal de notificación y almacena el resultado en la variable $Channel.
El tercer comando usa el cmdlet Add-SCOMNotificationSubscription con los parámetros Name, Subscriber y Channel .
Ejemplo 2: Agregar una suscripción de notificación con condiciones
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" -DisabledEn este ejemplo se agrega una nueva suscripción de notificación para todas las alertas, pero solo se notifica si las condiciones permanecen sin cambios durante 1 hora. En el ejemplo se crea la suscripción en estado deshabilitado.
El primer comando usa el cmdlet Get-SCOMNotificationSubscriber para obtener suscriptores y almacena el resultado en la variable $Subscriber.
El segundo comando usa el cmdlet Get-SCOMNotificationChannel para obtener el canal de notificación y almacena el resultado en la variable $Channel.
El tercer comando usa el cmdlet Add-SCOMNotificationSubscription con los parámetros Name, Subscriber y Channel .
Ejemplo 3: Agregar una nueva suscripción para instancias de una clase específica
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()En este ejemplo se agrega una nueva suscripción de notificación para todas las alertas y, a continuación, se usa el SDK de Operations Manager para definir el ámbito de la suscripción a las alertas generadas por instancias de la clase HealthService.
El primer comando usa el cmdlet Get-SCOMNotificationSubscriber para obtener suscriptores y almacena el resultado en la variable $Subscriber.
El segundo comando usa el cmdlet Get-SCOMNotificationChannel para obtener el canal de notificación y almacena el resultado en la variable $Channel.
El tercer comando usa el cmdlet Add-SCOMNotificationSubscription con los parámetros Name, Subscriber y Channel . El cmdlet almacena el resultado en la variable $Subscription.
El cuarto comando usa el cmdlet Get-SCOMClass y almacena el resultado en la variable $HealthService.
El quinto comando usa el método Add con el identificador de la variable $HealthService.
El sexto comando usa el método Update.
Ejemplo 4: Adición de una suscripción de notificación mediante el 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()En este ejemplo se agrega una nueva suscripción de notificación para todas las alertas y, a continuación, se usa el SDK de Operations Manager para limitar el ámbito de la suscripción a las alertas generadas por instancias del grupo Todos los equipos Windows.
El primer comando usa el cmdlet Get-SCOMNotificationSubscriber para obtener suscriptores y almacena el resultado en la variable $Subscriber.
El segundo comando usa el cmdlet Get-SCOMNotificationChannel para obtener el canal de notificación y almacena el resultado en la variable $Channel.
El tercer comando usa el cmdlet Add-SCOMNotificationSubscription con los parámetros Name, Subscriber y Channel . El cmdlet almacena el resultado en la variable $Subscription.
El cuarto comando usa el cmdlet Get-SCOMGroup para obtener el grupo Todos los equipos Windows y almacena el resultado en la variable $WindowsComputers.
El quinto comando usa el método Add con el identificador de la variable $WindowsComputers.
El sexto comando usa el método Update.
Ejemplo 5: Agregar una suscripción de notificación para un monitor específico
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 $CriteriaEn este ejemplo se agrega una nueva suscripción de notificación para todas las alertas críticas generadas por el monitor que tiene el nombre para mostrar ContosoMonitor.
El primer comando usa el cmdlet Get-SCOMNotificationSubscriber para obtener suscriptores y almacena el resultado en la variable $Subscriber.
El segundo comando usa el cmdlet Get-SCOMNotificationChannel para obtener el canal de notificación y almacena el resultado en la variable $Channel.
El tercer comando usa el cmdlet Get-SCOMMonitor y almacena el resultado en la variable $Monitor.
El cuarto comando almacena los criterios XML en la variable $Criteria.
El quinto comando usa el cmdlet Add-SCOMNotificationSubscription con los parámetros Name, Subscriber, Channel y Criteria .
Parámetros
-BccSubscriber
Especifica una matriz de suscriptores para una copia de carbono ciega (CCO) en un mensaje para una suscripción.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CcSubscriber
Especifica una matriz de suscriptores para copiar carbono (CC) en un mensaje de una suscripción.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Channel
Especifica una matriz de canales de notificación. Para obtener un objeto de canal de notificación, use el cmdlet Get-SCOMNotificationChannel .
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres netBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Especifica un objeto PSCredential para la conexión del grupo de administración.
Para obtener un objeto PSCredential, use el cmdlet Get-Credential.
Para obtener más información, escriba Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Criteria
Especifica el xml de criterios que indica cómo filtrar las alertas de esta suscripción. Los criterios pueden filtrar por reglas o monitores concretos, o propiedades de la alerta, pero no pueden filtrar por clases o grupos.
Puede copiar manualmente el xml de criterios de una suscripción existente.
Para obtener el xml criteria de una suscripción existente, use este modelo: $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
Especifica un retraso, en HH:MM:SS, para enviar notificaciones si las condiciones permanecen sin cambios durante este período de tiempo. De forma predeterminada, Operations Manager envía notificaciones inmediatamente.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
Especifica una descripción para la suscripción de notificación. Si no especifica una descripción, el parámetro tiene como valor predeterminado el valor del parámetro DisplayName .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Disabled
Indica que el cmdlet crea una suscripción, pero la deja en un estado deshabilitado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Especifica un nombre para mostrar para la suscripción. Si no especifica una descripción, el parámetro tiene como valor predeterminado el valor del parámetro Name .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica un nombre para la suscripción.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OnlyOnResolutionChange
Indica que la notificación solo se produce cuando cambia el estado de resolución de la alerta.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PollingInterval
Especifica un intervalo de sondeo para las alertas. Si no especifica este parámetro, el intervalo tiene como valor predeterminado 1 minuto.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Especifica una matriz de objetos Connection . Para obtener un objeto Connection , use el cmdlet Get-SCManagementGroupConnection .
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subscriber
Especifica una matriz de suscriptores para esta suscripción. Para obtener un objeto de suscriptor de notificación, use el cmdlet Get-SCOMNotificationSubscriber .
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |