Partilhar via

Add-SCOMNotificationSubscription

  • Referência
Módulo:
OperationsManager

Adiciona uma assinatura de notificação.

Sintaxe

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

O cmdlet Add-SCOMNotificationSubscription adiciona uma assinatura de notificação no System Center - Operations Manager.

Nesta versão, não há suporte a cmdlets para definir o escopo de assinaturas com base em um critério, mas você pode obter esse resultado por meio do Windows PowerShell acessando diretamente o SDK SCOM.

Exemplos

Exemplo 1: Adicionar uma assinatura de notificação

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

Este exemplo adiciona uma nova assinatura de notificação para todos os alertas.

O primeiro comando usa o cmdlet Get-SCOMNotificationSubscriber para obter assinantes e armazena o resultado na variável $Subscriber.

O segundo comando usa o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.

O terceiro comando usa o cmdlet Add-SCOMNotificationSubscription com os parâmetros Name, Subscribere Channel.

Exemplo 2: Adicionar uma assinatura de notificação com condições

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

Este exemplo adiciona uma nova assinatura de notificação para todos os alertas, mas só notifica se as condições permanecerem inalteradas por 1 hora. O exemplo cria a assinatura no estado desabilitado.

O primeiro comando usa o cmdlet Get-SCOMNotificationSubscriber para obter assinantes e armazena o resultado na variável $Subscriber.

O segundo comando usa o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.

O terceiro comando usa o cmdlet Add-SCOMNotificationSubscription com os parâmetros Name, Subscribere Channel.

Exemplo 3: Adicionar uma nova assinatura para instâncias de uma classe 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()

Este exemplo adiciona uma nova assinatura de notificação para todos os alertas e, em seguida, usa o SDK do Operations Manager para definir o escopo da assinatura de alertas gerados por instâncias da classe HealthService.

O primeiro comando usa o cmdlet Get-SCOMNotificationSubscriber para obter assinantes e armazena o resultado na variável $Subscriber.

O segundo comando usa o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.

O terceiro comando usa o cmdlet Add-SCOMNotificationSubscription com os parâmetros Name, Subscribere Channel. O cmdlet armazena o resultado na variável $Subscription.

O quarto comando usa o cmdlet Get-SCOMClass e armazena o resultado na variável $HealthService.

O quinto comando usa o método Add com a ID da variável $HealthService.

O sexto comando usa o método Update.

Exemplo 4: Adicionar uma assinatura de notificação usando o 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()

Este exemplo adiciona uma nova assinatura de notificação para todos os alertas e, em seguida, usa o SDK do Operations Manager para definir o escopo da assinatura para alertas gerados por instâncias no grupo Todos os Computadores Windows.

O primeiro comando usa o cmdlet Get-SCOMNotificationSubscriber para obter assinantes e armazena o resultado na variável $Subscriber.

O segundo comando usa o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.

O terceiro comando usa o cmdlet Add-SCOMNotificationSubscription com os parâmetros Name, Subscribere Channel. O cmdlet armazena o resultado na variável $Subscription.

O quarto comando usa o cmdlet Get-SCOMGroup para obter o grupo Todos os Computadores Windows e armazena o resultado na variável $WindowsComputers.

O quinto comando usa o método Add com o Id da variável $WindowsComputers.

O sexto comando usa o método Update.

Exemplo 5: Adicionar uma assinatura de notificação para um 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

Este exemplo adiciona uma nova assinatura de notificação para todos os alertas críticos gerados pelo monitor que tem o nome de exibição ContosoMonitor.

O primeiro comando usa o cmdlet Get-SCOMNotificationSubscriber para obter assinantes e armazena o resultado na variável $Subscriber.

O segundo comando usa o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.

O terceiro comando usa o cmdlet Get-SCOMMonitor e armazena o resultado na variável $Monitor.

O quarto comando armazena os critérios XML na variável $Criteria.

O quinto comando usa o cmdlet Add-SCOMNotificationSubscription com os parâmetros Name, Subscriber, Channele Criteria.

Parâmetros

-BccSubscriber

Especifica uma matriz de assinantes para cópia oculta (BCC) em uma mensagem para uma assinatura.

Tipo:NotificationRecipient[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-CcSubscriber

Especifica uma matriz de assinantes da cópia carbono (CC) em uma mensagem para uma assinatura.

Tipo:NotificationRecipient[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Channel

Especifica uma matriz de canais de notificação. Para obter um objeto de canal de notificação, use o cmdlet Get-SCOMNotificationChannel.

Tipo:Object[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica um objeto PSCredential para a conexão do grupo de gerenciamento. Para obter um objeto PSCredential , use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Criteria

Especifica o xml de critérios que indica como filtrar alertas para esta assinatura. Os critérios podem filtrar regras ou monitores específicos ou propriedades do alerta, mas não podem filtrar classes ou grupos.

Você pode copiar manualmente os critérios xml de uma assinatura existente. Para obter os critérios xml de uma assinatura existente, use este modelo: $subscription = Get-SCOMNotificationSubscription | Select-Object -First 1 $criteria = $subscription.Configuration.Criteria.

Tipo:String
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Delay

Especifica um atraso, em HH:MM:SS, para o envio de notificações se as condições permanecerem inalteradas durante este período de tempo. Por padrão, o Operations Manager envia notificações imediatamente.

Tipo:TimeSpan
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Description

Especifica uma descrição para a assinatura de notificação. Se você não especificar uma descrição, o parâmetro assumirá como padrão o valor do parâmetro DisplayName.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Disabled

Indica que o cmdlet cria uma assinatura, mas a deixa em um estado desabilitado.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayName

Especifica um nome para exibição para a assinatura. Se você não especificar uma descrição, o parâmetro assumirá como padrão o valor do parâmetro Name .

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica um nome para a assinatura.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OnlyOnResolutionChange

Indica que a notificação ocorre somente quando o estado de resolução do alerta é alterado.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PollingInterval

Especifica um intervalo de sondagem para alertas. Se você não especificar esse parâmetro, o intervalo será padronizado para 1 minuto.

Tipo:TimeSpan
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SCSession

Especifica uma matriz de objetos Connection. Para obter um objeto Connection, use o cmdlet Get-SCManagementGroupConnection.

Tipo:Connection[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Subscriber

Especifica uma matriz de assinantes para esta assinatura. Para obter um objeto de assinante de notificação, use o cmdlet Get-SCOMNotificationSubscriber.

Tipo:NotificationRecipient[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False