Add-SCOMNotificationSubscription
Ajoute un abonnement aux notifications.
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
L’applet de commande Add-SCOMNotificationSubscription ajoute un abonnement aux notifications dans System Center - Operations Manager.
Dans cette version, il n’existe aucune prise en charge des applets de commande pour les abonnements d’étendue en fonction d’un critère, mais vous pouvez obtenir ce résultat via Windows PowerShell en accédant directement au Kit de développement logiciel (SDK) SCOM.
Exemples
Exemple 1 : Ajouter un abonnement aux notifications
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 $ChannelCet exemple ajoute un nouvel abonnement aux notifications pour toutes les alertes.
La première commande utilise l’applet de commande Get-SCOMNotificationSubscriber pour obtenir les abonnés et stocke le résultat dans la variable $Subscriber.
La deuxième commande utilise l’applet de commande Get-SCOMNotificationChannel pour obtenir le canal de notification et stocke le résultat dans la variable $Channel.
La troisième commande utilise l’applet de commande Add-SCOMNotificationSubscription avec les paramètres Name, Subscriber et Channel .
Exemple 2 : Ajouter un abonnement de notification avec des conditions
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" -DisabledCet exemple montre comment ajouter un nouvel abonnement aux notifications pour toutes les alertes, mais uniquement si les conditions restent inchangées pendant 1 heure. L’exemple crée l’abonnement à l’état désactivé.
La première commande utilise l’applet de commande Get-SCOMNotificationSubscriber pour obtenir les abonnés et stocke le résultat dans la variable $Subscriber.
La deuxième commande utilise l’applet de commande Get-SCOMNotificationChannel pour obtenir le canal de notification et stocke le résultat dans la variable $Channel.
La troisième commande utilise l’applet de commande Add-SCOMNotificationSubscription avec les paramètres Name, Subscriber et Channel .
Exemple 3 : Ajouter un nouvel abonnement pour les instances d’une classe spécifique
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()Cet exemple ajoute un nouvel abonnement aux notifications pour toutes les alertes, puis utilise le Kit de développement logiciel (SDK) Operations Manager pour étendre l’abonnement aux alertes déclenchées par les instances de la classe HealthService.
La première commande utilise l’applet de commande Get-SCOMNotificationSubscriber pour obtenir les abonnés et stocke le résultat dans la variable $Subscriber.
La deuxième commande utilise l’applet de commande Get-SCOMNotificationChannel pour obtenir le canal de notification et stocke le résultat dans la variable $Channel.
La troisième commande utilise l’applet de commande Add-SCOMNotificationSubscription avec les paramètres Name, Subscriber et Channel . L’applet de commande stocke le résultat dans la variable $Subscription.
La quatrième commande utilise l’applet de commande Get-SCOMClass et stocke le résultat dans la variable $HealthService.
La cinquième commande utilise la méthode Add avec l’ID de la variable $HealthService.
La sixième commande utilise la méthode Update.
Exemple 4 : Ajouter un abonnement aux notifications à l’aide du Kit de développement logiciel (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()Cet exemple montre comment ajouter un nouvel abonnement aux notifications pour toutes les alertes, puis utiliser le Kit de développement logiciel (SDK) Operations Manager pour étendre l’abonnement aux alertes déclenchées par les instances du groupe Tous les ordinateurs Windows.
La première commande utilise l’applet de commande Get-SCOMNotificationSubscriber pour obtenir les abonnés et stocke le résultat dans la variable $Subscriber.
La deuxième commande utilise l’applet de commande Get-SCOMNotificationChannel pour obtenir le canal de notification et stocke le résultat dans la variable $Channel.
La troisième commande utilise l’applet de commande Add-SCOMNotificationSubscription avec les paramètres Name, Subscriber et Channel . L’applet de commande stocke le résultat dans la variable $Subscription.
La quatrième commande utilise l’applet de commande Get-SCOMGroup pour obtenir le groupe Tous les ordinateurs Windows et stocke le résultat dans la variable $WindowsComputers.
La cinquième commande utilise la méthode Add avec l’ID de la variable $WindowsComputers.
La sixième commande utilise la méthode Update.
Exemple 5 : Ajouter un abonnement aux notifications pour un moniteur spécifique
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 $CriteriaCet exemple montre comment ajouter un nouvel abonnement aux notifications pour toutes les alertes critiques déclenchées par le moniteur avec le nom d’affichage ContosoMonitor.
La première commande utilise l’applet de commande Get-SCOMNotificationSubscriber pour obtenir les abonnés et stocke le résultat dans la variable $Subscriber.
La deuxième commande utilise l’applet de commande Get-SCOMNotificationChannel pour obtenir le canal de notification et stocke le résultat dans la variable $Channel.
La troisième commande utilise l’applet de commande Get-SCOMMonitor et stocke le résultat dans la variable $Monitor.
La quatrième commande stocke les critères XML dans la variable $Criteria.
La cinquième commande utilise l’applet de commande Add-SCOMNotificationSubscription avec les paramètres Name, Subscriber, Channel et Criteria .
Paramètres
-BccSubscriber
Spécifie un tableau d’abonnés à la copie carbone aveugle (BCC) sur un message pour un abonnement.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CcSubscriber
Spécifie un tableau d’abonnés à la copie carbone (CC) sur un message pour un abonnement.
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Channel
Spécifie un tableau de canaux de notification. Pour obtenir un objet de canal de notification, utilisez l’applet de commande Get-SCOMNotificationChannel .
| Type: | Object[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec des groupes d’administration pour ces ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Spécifie un objet PSCredential pour la connexion au groupe d’administration.
Pour obtenir un objet PSCredential, utilisez l'applet de commande Get-Credential.
Pour plus d'informations, voir Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Criteria
Spécifie le xml de critères qui indique comment filtrer les alertes pour cet abonnement. Les critères peuvent filtrer sur des règles ou des analyses particulières, ou sur des propriétés de l’alerte, mais ne peuvent pas filtrer sur des classes ou des groupes.
Vous pouvez copier manuellement le xml des critères à partir d’un abonnement existant.
Pour obtenir les critères xml à partir d’un abonnement existant, utilisez ce modèle : $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
Spécifie un délai, dans HH :MM :SS, pour l’envoi de notifications si les conditions restent inchangées pendant cette période. Par défaut, Operations Manager envoie des notifications immédiatement.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
Spécifie une description de l’abonnement aux notifications. Si vous ne spécifiez pas de description, le paramètre prend par défaut la valeur du paramètre DisplayName .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Disabled
Indique que l’applet de commande crée un abonnement, mais le laisse dans un état désactivé.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Spécifie un nom d’affichage pour l’abonnement. Si vous ne spécifiez pas de description, le paramètre prend par défaut la valeur du paramètre Name .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Spécifie un nom pour l’abonnement.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OnlyOnResolutionChange
Indique que la notification se produit uniquement lorsque l’état de résolution de l’alerte change.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PollingInterval
Spécifie un intervalle d’interrogation pour les alertes. Si vous ne spécifiez pas ce paramètre, l’intervalle est de 1 minute par défaut.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Spécifie un tableau d’objets Connection . Pour obtenir un objet Connection , utilisez l’applet de commande Get-SCManagementGroupConnection .
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subscriber
Spécifie un tableau d’abonnés pour cet abonnement. Pour obtenir un objet abonné aux notifications, utilisez l’applet de commande Get-SCOMNotificationSubscriber .
| Type: | NotificationRecipient[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |