sp_update_operator (Transact-SQL)
Met à jour des informations sur un opérateur (destinataire de la notification) à utiliser pour les alertes et les travaux.
.gif "Icône Lien de rubrique")
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