Add-SCOMNotificationSubscription
Adiciona uma assinatura de notificação.
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
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 assinaturas de escopo com base em um critério, mas você pode obter esse resultado por meio de Windows PowerShell acessando o SDK do SCOM diretamente.
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 $ChannelEste 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 Nome, Assinante e Canal .
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" -DisabledEste exemplo adiciona uma nova assinatura de notificação para todos os alertas, mas só notifica se as condições permanecem 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 Nome, Assinante e Canal .
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 para 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 Nome, Assinante e Canal . 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 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 Nome, Assinante e Canal . 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 a 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 $CriteriaEste 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 Nome, Assinante, Canal e Critérios .
Parâmetros
-BccSubscriber
Especifica uma matriz de assinantes para copiar carbono cego (BCC) em uma mensagem para uma assinatura.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CcSubscriber
Especifica uma matriz de assinantes para cc (cópia carbono) em uma mensagem para uma assinatura.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Channel
Especifica uma matriz de canais de notificação. Para obter um objeto de canal de notificação, use o cmdlet Get-SCOMNotificationChannel .
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 (.).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Criteria
Especifica os critérios xml que indicam como filtrar alertas para essa 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.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Delay
Especifica um atraso, em HH:MM:SS, para enviar notificações se as condições permanecerem inalteradas para esse período de tempo. Por padrão, o Operations Manager envia notificações imediatamente.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
Especifica uma descrição para a assinatura de notificação. Se você não especificar uma descrição, o parâmetro usará como padrão o valor do parâmetro DisplayName .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Disabled
Indica que o cmdlet cria uma assinatura, mas a deixa em um estado desabilitado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Especifica um nome de exibição para a assinatura. Se você não especificar uma descrição, o parâmetro usará como padrão o valor do parâmetro Name .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica um nome para a assinatura.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OnlyOnResolutionChange
Indica que a notificação ocorre somente quando o estado de resolução do alerta é alterado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PollingInterval
Especifica um intervalo de sondagem para alertas. Se você não especificar esse parâmetro, o intervalo será padronizado como 1 minuto.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Especifica uma matriz de objetos Connection . Para obter um objeto Connection , use o cmdlet Get-SCManagementGroupConnection .
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subscriber
Especifica uma matriz de assinantes para esta assinatura. Para obter um objeto assinante de notificação, use o cmdlet Get-SCOMNotificationSubscriber .
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |