Compartir a través de

Add-SCOMNotificationSubscription

  • Referencia
Módulo:
OperationsManager

Agrega una suscripción de notificación.

Sintaxis

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 $Channel

En 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 add-SCOMNotificationSubscription con los parámetros Name, suscriptory 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" -Disabled

En 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 add-SCOMNotificationSubscription con los parámetros Name, suscriptory 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 add-SCOMNotificationSubscription con los parámetros Name, suscriptory 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 definir 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 add-SCOMNotificationSubscription con los parámetros Name, suscriptory 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 $Criteria

En 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, Channely Criteria.

Parámetros

-BccSubscriber

Especifica una matriz de suscriptores para copiar carbono ciego (BCC) en un mensaje de una suscripción.

Tipo:NotificationRecipient[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-CcSubscriber

Especifica una matriz de suscriptores para copiar carbono (CC) en un mensaje de una suscripción.

Tipo:NotificationRecipient[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Channel

Especifica una matriz de canales de notificación. Para obtener un objeto de canal de notificación, use el cmdlet Get-SCOMNotificationChannel.

Tipo:Object[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 (.).

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica un objeto de PSCredential para la conexión del grupo de administración. Para obtener un objeto de de PSCredential, use el cmdlet get-credential de . Para obtener más información, escriba Get-Help Get-Credential.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 de criterios de una suscripción existente, use este modelo: $subscription = Get-SCOMNotificationSubscription | Select-Object -First 1 $criteria = $subscription.Configuration.Criteria.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:TimeSpan
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Description

Especifica una descripción de 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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Disabled

Indica que el cmdlet crea una suscripción pero la deja en estado deshabilitado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica un nombre para la suscripción.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-OnlyOnResolutionChange

Indica que la notificación solo se produce cuando cambia el estado de resolución de la alerta.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PollingInterval

Especifica un intervalo de sondeo para las alertas. Si no especifica este parámetro, el intervalo tiene como valor predeterminado 1 minuto.

Tipo:TimeSpan
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SCSession

Especifica una matriz de objetos connection. Para obtener un objeto connection de , use el cmdlet get-SCManagementGroupConnection de .

Tipo:Connection[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Subscriber

Especifica una matriz de suscriptores para esta suscripción. Para obtener un objeto de suscriptor de notificaciones, use el cmdlet Get-SCOMNotificationSubscriber.

Tipo:NotificationRecipient[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False