Add-SCOMNotificationChannel
Ajoute un canal de notification dans Operations Manager.
Syntaxe
Add-SCOMNotificationChannel
[-Name] <String>
[-Port <UInt32>]
[-DisplayName <String>]
[-Description <String>]
-Server <String>
[-From] <String>
[-ReplyTo <String>]
[-Header <Hashtable>]
[-Anonymous]
[-ExternalEmail]
[-ExternalEmailRunasProfile <String>]
[-BackupSmtpServer <String[]>]
[-MaxPrimaryRecipientsPerMail <Int32>]
[-PrimaryRetryInterval <TimeSpan>]
[-Subject <String>]
-Body <String>
[-BodyAsHtml]
[-Encoding <String>]
[-NoSubjectEncoding]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMNotificationChannel
[-Name] <String>
[-Port <UInt32>]
[-DisplayName <String>]
[-Description <String>]
[-UserName] <Uri>
[-ContentType <String>]
-Server <String>
[-SipProtocol <SipTransportProtocol>]
[-SipAuthentication <SipNotificationAuthenticationProtocols>]
[-PreferredUserName <String>]
-Body <String>
[-Encoding <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMNotificationChannel
[-Name] <String>
[-DisplayName <String>]
[-Description <String>]
[-ApplicationPath] <String>
[[-Argument] <String>]
[-WorkingDirectory <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMNotificationChannel
[-Name] <String>
[-DisplayName <String>]
[-Description <String>]
[-PrimaryRetryInterval <TimeSpan>]
[-DeviceEnumerationInterval <TimeSpan>]
[-Sms]
[[-Device] <String>]
[[-BackupDevice] <String[]>]
-Body <String>
[-Encoding <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande Add-SCOMNotificationChannel ajoute un canal de notification dans System Center - Operations Manager. Les canaux de notification informent les administrateurs d’une alerte ou exécutent l’automatisation en réponse à une alerte. Un canal de notification utilise un mécanisme de remise dans Operations Manager, tel que l’e-mail, la messagerie instantanée, le service sms (Short Message Service) ou la commande, pour remettre des notifications.
Exemples
Exemple 1 : Ajouter un canal de notification
PS C:\>$Subject = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> $Body = "Owner is `$Data[Default='Not Present']/Context/DataItem/AlertOwner`$"
PS C:\> Add-SCOMNotificationChannel -Name "Contoso.Email" -Server "mail.contoso.com" -From "scom@contoso.net" -Subject $Subject -Body $BodyCet exemple ajoute un canal de messagerie SMTP standard.
La première commande stocke la ligne d’objet dans la variable nommée $Subject.
La deuxième commande stocke le corps du message dans la variable nommée $Body.
La troisième commande utilise l’applet de commande Add-SCOMNotificationChannel pour ajouter un canal de messagerie SMTP.
Exemple 2 : Ajouter un canal de notification pour la messagerie instantanée
PS C:\>$Body = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> Add-SCOMNotificationChannel -Name "Contoso.IM" -Server "sipserver.contoso.com" -UserName 'sip:scomadmin' -Body $BodyCet exemple ajoute un canal de messagerie instantanée qui a une adresse de retour de scomadmin.
La première commande stocke le corps du message dans la variable nommée $Body.
La deuxième commande utilise l’applet de commande Add-SCOMNotificationChannel pour ajouter un canal de messagerie instantanée.
Exemple 3 : Ajouter un canal de notification pour SMS
PS C:\>$Body = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> Add-SCOMNotificationChannel -Sms -Name "Contoso.SMS" -Body $Body -Encoding "Unicode"Cet exemple ajoute un canal SMS qui a un encodage Unicode.
La première commande stocke le corps du message dans la variable nommée $Body.
La deuxième commande utilise l’applet de commande Add-SCOMNotificationChannel pour ajouter un canal SMS.
Exemple 4 : Ajouter un canal de notification de commande
PS C:\>$Path = "C:\OnNotify.exe"
PS C:\> $Arg = "/notify /owner `"`$Data[Default='Not Present']/Context/DataItem/AlertOwner`$`""
PS C:\> $WorkingDir = "C:\"
PS C:\> Add-SCOMNotificationChannel -Name "Contoso.Command" -ApplicationPath $Path -Argument $Arg -WorkingDirectory $WorkingDirCet exemple montre comment ajouter un canal de notification de commande qui exécute le programme OnNotify.exe.
La première commande stocke le chemin d’accès au fichier exécutable dans la variable nommée $Path.
La deuxième commande stocke les arguments dans la variable nommée $Arg.
La troisième commande stocke le répertoire de travail dans la variable nommée $WorkingDir.
La quatrième commande utilise l’applet de commande Add-SCOMNotificationChannel pour ajouter un canal de notification de commande.
Paramètres
-Anonymous
Indique qu’un serveur SMTP (Simple Mail Transfer Protocol) anonyme envoie des notifications par e-mail.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ApplicationPath
Spécifie le chemin d’accès de l’application d’un canal de commande.
| Type: | String |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Argument
Spécifie une liste d’arguments sur un canal de commande.
| Type: | String |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BackupDevice
Spécifie un tableau d’appareils SMS secondaires.
| Type: | String[] |
| Position: | 3 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-BackupSmtpServer
Spécifie un tableau de serveurs SMTP de sauvegarde. Les serveurs de sauvegarde utilisent la même configuration que le serveur SMTP principal.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Body
Spécifie le corps d’un message de notification.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-BodyAsHtml
Indique que le service met en forme le corps du message au format HTML.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ContentType
Spécifie le type de contenu d’un message instantané.
Par défaut, le type de contenu est text/plain.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Credential
Spécifie un objet PSCredential pour la connexion de groupe d’administration.
Pour obtenir un objet Get-Help Get-Credential».
Si vous spécifiez un ordinateur dans le paramètre ComputerName, utilisez un compte qui a accès à cet ordinateur. La valeur par défaut est l’utilisateur actuel.
| Type: | PSCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Description
Spécifie une description pour un canal de notification. Si vous ne définissez pas de valeur, la valeur par défaut est la valeur du paramètre DisplayName.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Device
Spécifie un appareil SMS principal.
| Type: | String |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-DeviceEnumerationInterval
Spécifie un intervalle de temps entre les notifications SMS. Par défaut, le canal de notification attend 10 secondes.
| Type: | TimeSpan |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-DisplayName
Spécifie un nom complet pour un canal de notification. Si vous ne définissez pas de valeur, la valeur par défaut est la valeur du paramètre Name.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Encoding
Spécifie le format d’encodage d’un message de notification. Un canal SMTP utilise l’encodage UTF-8 par défaut. Un canal de messagerie instantanée utilise également l’encodage UTF-8 par défaut. Un canal SMS utilise l’encodage par défaut, mais peut également utiliser l’encodage Unicode.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ExternalEmail
Spécifie s’il faut utiliser un e-mail externe.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ExternalEmailRunasProfile
Spécifie le profil d’identification pour l’e-mail externe.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-From
Spécifie l’en-tête From dans un message électronique de notification.
| Type: | String |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Header
Spécifie les en-têtes, en tant que paires clé-valeur, dans un message électronique de notification.
| Type: | Hashtable |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-MaxPrimaryRecipientsPerMail
Spécifie le nombre maximal de destinataires pour un e-mail de notification.
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom d’un canal de notification.
| Type: | String |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-NoSubjectEncoding
Indique que l’applet de commande n’encode pas la ligne d’objet de l’e-mail.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Port
Spécifie le numéro de port d’un canal.
Un canal SMTP utilise le port 25 par défaut. Un canal de messagerie instantanée qui utilise TCP utilise le port 5060 par défaut, et un canal de messagerie instantanée qui utilise le protocole TLS (Transport Layer Security) utilise le port 5061 par défaut.
| Type: | UInt32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-PreferredUserName
Spécifie le nom d’utilisateur préféré d’un canal de messagerie instantanée.
Si vous ne définissez pas de valeur, la valeur par défaut est la valeur du paramètre nom d’utilisateur
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-PrimaryRetryInterval
Spécifie un intervalle de nouvelle tentative. Le service tente de revenir au serveur SMTP principal ou à l’appareil SMS. Par défaut, l’intervalle est de cinq minutes.
| Type: | TimeSpan |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ReplyTo
Spécifie l’en-tête Réponse à la réponse dans un e-mail de notification.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-SCSession
Spécifie un tableau d’objets Connection.
Pour obtenir un objet Connection
Entrez un objet de connexion pour un groupe d’administration, tel que celui retourné par l’applet de commande Get-SCManagementGroupConnection
| Type: | Connection[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Server
Spécifie un serveur qui fournit des canaux SMTP et de messagerie instantanée pour les notifications.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-SipAuthentication
Spécifie un mécanisme d’authentification SIP (Session Initiation Protocol) (NTLM ou Kerberos) pour les canaux de messagerie instantanée. Par défaut, l’authentification SIP utilise l’authentification NTLM.
| Type: | SipNotificationAuthenticationProtocols |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-SipProtocol
Spécifie un protocole de transport SIP (TCP ou TLS) pour les canaux de messagerie instantanée. Par défaut, SIP utilise TCP comme protocole de transport.
| Type: | SipTransportProtocol |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Sms
Indique que l’applet de commande envoie des notifications à l’aide de SMS.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Subject
Spécifie une ligne d’objet pour le message électronique de notification.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-UserName
Spécifie une adresse de retour pour la messagerie instantanée.
| Type: | Uri |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WorkingDirectory
Spécifie un répertoire de travail pour un canal de commande. Par défaut, un canal de commande utilise le %systemdrive% comme répertoire de travail.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |