Add-SCOMNotificationSubscription
Agrega una suscripción de notificación.
Sintaxis
Default (Es el valor predeterminado).
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
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
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
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
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.
Propiedades del parámetro
| Tipo: | NotificationRecipient[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-CcSubscriber
Especifica una matriz de suscriptores para copiar carbono (CC) en un mensaje de una suscripción.
Propiedades del parámetro
| Tipo: | NotificationRecipient[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Channel
Especifica una matriz de canales de notificación.
Para obtener un objeto de canal de notificación, use el cmdlet
Propiedades del parámetro
| Tipo: | Object[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | 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 (.).
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Credential
Especifica un objeto de PSCredential para la conexión del grupo de administración.
Para obtener un objeto de de Get-Help Get-Credential.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 3 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | TimeSpan |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Disabled
Indica que el cmdlet crea una suscripción pero la deja en estado deshabilitado.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Name
Especifica un nombre para la suscripción.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-OnlyOnResolutionChange
Indica que la notificación solo se produce cuando cambia el estado de resolución de la alerta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-PollingInterval
Especifica un intervalo de sondeo para las alertas. Si no especifica este parámetro, el intervalo tiene como valor predeterminado 1 minuto.
Propiedades del parámetro
| Tipo: | TimeSpan |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-SCSession
Especifica una matriz de objetos connection.
Para obtener un objeto connection de
Propiedades del parámetro
| Tipo: | Connection[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Subscriber
Especifica una matriz de suscriptores para esta suscripción.
Para obtener un objeto de suscriptor de notificaciones, use el cmdlet
Propiedades del parámetro
| Tipo: | NotificationRecipient[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.