Add-SCOMNotificationSubscription
Ajoute un abonnement aux notifications.
Syntaxe
Default (Par défaut)
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 de notification dans System Center - Operations Manager.
Dans cette version, il n’existe pas de prise en charge de l’applet de commande pour l’étendue des abonnements en fonction d’un critère, mais vous pouvez obtenir ce résultat via Windows PowerShell en accédant directement au 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 $Channel
Cet 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" -Disabled
Cet exemple ajoute un nouvel abonnement aux notifications pour toutes les alertes, mais n’avertit que 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 de notification 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 de notification à l’aide du 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 ajoute un nouvel abonnement de notification 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 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 de notification 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 $Criteria
Cet exemple ajoute un nouvel abonnement de notification pour toutes les alertes critiques déclenchées par le moniteur qui porte le nom complet 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 invisible (BCC) sur un message pour un abonnement.
Propriétés du paramètre
| Type: | NotificationRecipient[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-CcSubscriber
Spécifie un tableau d’abonnés à la copie carbone (CC) sur un message pour un abonnement.
Propriétés du paramètre
| Type: | NotificationRecipient[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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 .
Propriétés du paramètre
| Type: | Object[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ComputerName
Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec les 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 (.).
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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, tapez Get-Help Get-Credential.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Criteria
Spécifie le critère xml qui indique comment filtrer les alertes pour cet abonnement. Les critères peuvent filtrer sur des règles ou des moniteurs particuliers, 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 critère xml à partir d’un abonnement existant.
Pour obtenir le critère xml à partir d’un abonnement existant, utilisez le modèle suivant : $subscription = Get-SCOMNotificationSubscription | Select-Object -First 1 $criteria = $subscription.Configuration.Criteria.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 3 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Delay
Spécifie un délai, en HH :MM :SS, pour l’envoi de notifications si les conditions restent inchangées pendant cette période. Par défaut, Operations Manager envoie immédiatement des notifications.
Propriétés du paramètre
| Type: | TimeSpan |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Description
Spécifie une description de l’abonnement aux notifications. Si vous ne spécifiez pas de description, la valeur par défaut du paramètre DisplayName est définie par défaut.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Disabled
Indique que l’applet de commande crée un abonnement, mais le laisse dans un état désactivé.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 .
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Name
Spécifie un nom pour l’abonnement.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-OnlyOnResolutionChange
Indique que la notification se produit uniquement lorsque l’état de résolution de l’alerte change.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | TimeSpan |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-SCSession
Spécifie un tableau d’objets Connection . Pour obtenir un objet Connection , utilisez l’applet de commande Get-SCManagementGroupConnection .
Propriétés du paramètre
| Type: | Connection[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Subscriber
Spécifie un tableau d’abonnés pour cet abonnement. Pour obtenir un objet d’abonné de notification, utilisez l’applet de commande Get-SCOMNotificationSubscriber .
Propriétés du paramètre
| Type: | NotificationRecipient[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.