Add-SCOMNotificationSubscription
Adiciona uma assinatura de notificação.
Sintaxe
Default (Predefinição)
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.
Propriedades dos parâmetros
| Tipo: | NotificationRecipient[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-CcSubscriber
Especifica uma matriz de assinantes da cópia carbono (CC) em uma mensagem para uma assinatura.
Propriedades dos parâmetros
| Tipo: | NotificationRecipient[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Channel
Especifica uma matriz de canais de notificação. Para obter um objeto de canal de notificação, use o cmdlet Get-SCOMNotificationChannel.
Propriedades dos parâmetros
| Tipo: | Object[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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 (.).
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Especifica um objeto PSCredential Get-Help Get-Credential.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | TimeSpan |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Disabled
Indica que o cmdlet cria uma assinatura, mas a deixa em um estado desabilitado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Name
Especifica um nome para a assinatura.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-OnlyOnResolutionChange
Indica que a notificação ocorre somente quando o estado de resolução do alerta é alterado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-PollingInterval
Especifica um intervalo de sondagem para alertas. Se você não especificar esse parâmetro, o intervalo será padronizado para 1 minuto.
Propriedades dos parâmetros
| Tipo: | TimeSpan |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-SCSession
Especifica uma matriz de objetos Connection. Para obter um objeto Connection, use o cmdlet Get-SCManagementGroupConnection.
Propriedades dos parâmetros
| Tipo: | Connection[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Subscriber
Especifica uma matriz de assinantes para esta assinatura. Para obter um objeto de assinante de notificação, use o cmdlet Get-SCOMNotificationSubscriber.
Propriedades dos parâmetros
| Tipo: | NotificationRecipient[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.