sp_update_operator (Transact-SQL)
Met à jour des informations sur un opérateur (destinataire de la notification) à utiliser pour les alertes et les travaux.
Syntaxe
sp_update_operator
[@name =] 'name'
[ , [@new_name =] 'new_name']
[ , [@enabled =] enabled]
[ , [@email_address =] 'email_address']
[ , [@pager_address =] 'pager_number']
[ , [@weekday_pager_start_time =] weekday_pager_start_time]
[ , [@weekday_pager_end_time =] weekday_pager_end_time]
[ , [@saturday_pager_start_time =] saturday_pager_start_time]
[ , [@saturday_pager_end_time =] saturday_pager_end_time]
[ , [@sunday_pager_start_time =] sunday_pager_start_time]
[ , [@sunday_pager_end_time =] sunday_pager_end_time]
[ , [@pager_days =] pager_days]
[ , [@netsend_address =] 'netsend_address']
[ , [@category_name =] 'category']
Arguments
[ @name =] 'name'
Nom de l'opérateur à modifier. name est de type sysname, sans valeur par défaut.
[ @new_name =] 'new_name'
Nouveau nom de l'opérateur. Ce nom doit être unique. L'argument new_name est de type sysname, avec NULL comme valeur par défaut.
[ @enabled =] enabled
Nombre indiquant l'état actuel de l'opérateur (1 = activé, 0 = désactivé). L'argument enabled est de type tinyint, avec NULL comme valeur par défaut. S'il n'est pas activé, l'opérateur ne recevra pas de notifications d'alerte.
[ @email_address =] 'email_address'
Adresse électronique de l'opérateur. Cette chaîne est transmise directement au système de messagerie électronique. L'argument email_address est de type nvarchar(100), avec la valeur par défaut NULL.
[ @pager_address =] 'pager_number'
Adresse de radiomessagerie de l'opérateur. Cette chaîne est transmise directement au système de messagerie électronique. L'argument pager_number est de type nvarchar(100), avec la valeur par défaut NULL.
[ @weekday_pager_start_time =] weekday_pager_start_time
Indique l'heure à partir de laquelle une notification peut être envoyée à cet opérateur sur son récepteur de radiomessagerie, du lundi au vendredi. L'argument weekday_pager_start_timeest de type int, avec NULL comme valeur par défaut et il doit être entré au format HHMMSS (format horaire sur 24 heures).
[ @weekday_pager_end_time =] weekday_pager_end_time
Indique l'heure à partir de laquelle une notification ne peut pas être envoyée à l'opérateur spécifié sur son récepteur de radiomessagerie, du lundi au vendredi. L'argument weekday_pager_end_timeest de type int, avec NULL comme valeur par défaut et il doit être entré au format HHMMSS (format horaire sur 24 heures).
[ @saturday_pager_start_time =] saturday_pager_start_time
Indique l'heure à partir de laquelle une notification peut être envoyée le samedi à l'opérateur spécifié sur son récepteur de radiomessagerie. L'argument saturday_pager_start_time est de type int, avec NULL comme valeur par défaut et il doit être entré au format HHMMSS (format horaire sur 24 heures).
[ @saturday_pager_end_time =] saturday_pager_end_time
Indique l'heure à partir de laquelle une notification ne peut pas être envoyée le samedi à l'opérateur spécifié sur son récepteur de radiomessagerie. L'argument saturday_pager_end_time est de type int, avec NULL comme valeur par défaut et il doit être entré au format HHMMSS (format horaire sur 24 heures).
[ @sunday_pager_start_time =] sunday_pager_start_time
Indique l'heure à partir de laquelle une notification peut être envoyée le dimanche à l'opérateur spécifié sur son récepteur de radiomessagerie. L'argument sunday_pager_start_time est de type int, avec NULL comme valeur par défaut et il doit être entré au format HHMMSS (format horaire sur 24 heures).
[ @sunday_pager_end_time =] sunday_pager_end_time
Indique l'heure à partir de laquelle une notification ne peut pas être envoyée le dimanche à l'opérateur spécifié sur son récepteur de radiomessagerie. L'argument sunday_pager_end_time est de type int, avec NULL comme valeur par défaut et il doit être entré au format HHMMSS (format horaire sur 24 heures).
[ @pager_days =] pager_days
Indique les jours où l'opérateur est en mesure de recevoir des notifications par radiomessagerie (en fonction des heures de début/fin précisées). L'argument pager_days est de type tinyint, avec NULL comme valeur par défaut, et il doit avoir une valeur comprise entre 0 et 127. Le paramètre pager_days est calculé en additionnant les valeurs individuelles des jours requis. Par exemple, du lundi au vendredi, cela correspond à 2+4+8+16+32 = 64.
Valeur | Description |
---|---|
1 |
Dimanche |
2 |
Lundi |
4 |
Mardi |
8 |
Mercredi |
16 |
Jeudi |
32 |
Vendredi |
64 |
Samedi |
[ @netsend_address =] 'netsend_address'
Adresse réseau de l'opérateur à qui est envoyé le message. L'argument netsend_addressest de type nvarchar(100), avec NULL comme valeur par défaut.
[ @category_name =] 'category'
Nom de la catégorie de l'alerte. L'argument category est de type sysname, avec NULL comme valeur par défaut.
Valeurs des codes de retour
0 (succès) ou 1 (échec)
Notes
La procédure sp_update_operator doit être exécutée à partir de la base de données msdb.
Autorisations
Les autorisations d'exécution de cette procédure sont octroyées par défaut aux membres du rôle de serveur fixe sysadmin.
Exemples
L'exemple suivant met à jour l'état de l'opérateur en l'activant et définit les jours (du lundi au vendredi, de 8:00 à 17:00 heures) pendant lesquels il peut être averti par radiomessagerie.
USE msdb ;
GO
EXEC dbo.sp_update_operator
@name = N'François Ajenstat',
@enabled = 1,
@email_address = N'françoisa',
@pager_address = N'5551290AW@pager.Adventure-Works.com',
@weekday_pager_start_time = 080000,
@weekday_pager_end_time = 170000,
@pager_days = 62 ;
GO
Voir aussi
Référence
sp_add_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)
sp_help_operator (Transact-SQL)
Procédures stockées système (Transact-SQL)