Add-SCOMNotificationSubscription
Adiciona uma subscrição 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 subscrição de notificação no System Center – Operations Manager.
Nesta versão, não existe suporte de cmdlets para o âmbito de subscrições com base num critério, mas pode obter este resultado através de Windows PowerShell ao aceder diretamente ao SDK do SCOM.
Exemplos
Exemplo 1: Adicionar uma subscrição 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 subscrição de notificação para todos os alertas.
O primeiro comando utiliza o cmdlet Get-SCOMNotificationSubscriber para obter subscritores e armazena o resultado na variável $Subscriber.
O segundo comando utiliza o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.
O terceiro comando utiliza o cmdlet Add-SCOMNotificationSubscription com os parâmetros Nome, Subscritor e Canal .
Exemplo 2: Adicionar uma subscrição 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 subscrição de notificação para todos os alertas, mas apenas notifica se as condições permanecerem inalteradas durante 1 hora. O exemplo cria a subscrição no estado desativado.
O primeiro comando utiliza o cmdlet Get-SCOMNotificationSubscriber para obter subscritores e armazena o resultado na variável $Subscriber.
O segundo comando utiliza o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.
O terceiro comando utiliza o cmdlet Add-SCOMNotificationSubscription com os parâmetros Nome, Subscritor e Canal .
Exemplo 3: Adicionar uma nova subscrição 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 subscrição de notificação para todos os alertas e, em seguida, utiliza o SDK do Operations Manager para definir o âmbito da subscrição para alertas gerados por instâncias da classe HealthService.
O primeiro comando utiliza o cmdlet Get-SCOMNotificationSubscriber para obter subscritores e armazena o resultado na variável $Subscriber.
O segundo comando utiliza o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.
O terceiro comando utiliza o cmdlet Add-SCOMNotificationSubscription com os parâmetros Nome, Subscritor e Canal . O cmdlet armazena o resultado na variável $Subscription.
O quarto comando utiliza o cmdlet Get-SCOMClass e armazena o resultado na variável $HealthService.
O quinto comando utiliza o método Adicionar com o ID da variável $HealthService.
O sexto comando utiliza o método Update.
Exemplo 4: Adicionar uma subscrição de notificação com 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 subscrição de notificação para todos os alertas e, em seguida, utiliza o SDK do Operations Manager para definir o âmbito da subscrição para alertas gerados por instâncias no grupo Todos os Computadores Windows.
O primeiro comando utiliza o cmdlet Get-SCOMNotificationSubscriber para obter subscritores e armazena o resultado na variável $Subscriber.
O segundo comando utiliza o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.
O terceiro comando utiliza o cmdlet Add-SCOMNotificationSubscription com os parâmetros Nome, Subscritor e Canal . O cmdlet armazena o resultado na variável $Subscription.
O quarto comando utiliza o cmdlet Get-SCOMGroup para obter o grupo Todos os Computadores Windows e armazena o resultado na variável $WindowsComputers.
O quinto comando utiliza o método Add com o ID da variável $WindowsComputers.
O sexto comando utiliza o método Update.
Exemplo 5: Adicionar uma subscrição 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 subscrição de notificação para todos os alertas críticos gerados pelo monitor que tem o nome a apresentar ContosoMonitor.
O primeiro comando utiliza o cmdlet Get-SCOMNotificationSubscriber para obter subscritores e armazena o resultado na variável $Subscriber.
O segundo comando utiliza o cmdlet Get-SCOMNotificationChannel para obter o canal de notificação e armazena o resultado na variável $Channel.
O terceiro comando utiliza 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 utiliza o cmdlet Add-SCOMNotificationSubscription com os parâmetros Nome, Subscritor, Canal e Critérios .
Parâmetros
-BccSubscriber
Especifica uma matriz de subscritores para copiar carbono cego (BCC) numa mensagem para uma subscrição.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CcSubscriber
Especifica uma matriz de subscritores para a cópia de carbono (CC) numa mensagem para uma subscrição.
| 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, utilize 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 ligações temporárias com grupos de gestão para estes computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio completamente qualificados (FQDNs). Para especificar o computador local, escreva 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 a 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 ligação do grupo de gestão.
Para obter um objeto PSCredential , utilize o cmdlet Get-Credential .
Para mais informações, insira Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Criteria
Especifica o xml de critérios que indica como filtrar alertas para esta subscrição. Os critérios podem filtrar em regras ou monitores específicos, ou propriedades do alerta, mas não podem filtrar em classes ou grupos.
Pode copiar manualmente os critérios xml de uma subscrição existente.
Para obter os critérios xml de uma subscrição existente, utilize 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 durante este período de tempo. Por predefiniçã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 subscrição de notificação. Se não especificar uma descrição, o parâmetro é predefinido para 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 subscrição, mas deixa-a num estado desativado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Especifica um nome a apresentar para a subscrição. Se não especificar uma descrição, o parâmetro é predefinido para o valor do parâmetro Nome .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica um nome para a subscrição.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OnlyOnResolutionChange
Indica que a notificação só ocorre 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 consulta para alertas. Se não especificar este parâmetro, o intervalo é predefinido para 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 de Ligação . Para obter um objeto Ligação , utilize 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 subscritores para esta subscrição. Para obter um objeto de subscritor de notificação, utilize o cmdlet Get-SCOMNotificationSubscriber .
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |