sp_update_operator (Transact-SQL)

Article
08/19/2013

Met à jour des informations sur un opérateur (destinataire de la notification) à utiliser pour les alertes et les travaux.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

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 et n'a pas de valeur par défaut.
[ @new\_name=\] 'new_name'
Nouveau nom de l'opérateur. Ce nom doit être unique. 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é). 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. email_address est de type nvarchar(100), avec NULL comme valeur par défaut.
[ @pager\_address=\] 'pager_number'
Adresse de radiomessagerie de l'opérateur. Cette chaîne est transmise directement au système de messagerie électronique. pager_number est de type nvarchar(100), avec NULL comme valeur par défaut.
[ @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. 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. 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. saturday_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).
[ @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. saturday_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).
[ @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. sunday_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).
[ @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. sunday_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).
[ @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). pager_daysest de type tinyint, avec NULL comme valeur par défaut, et doit être compris entre 0 et 127. La valeur de l'argument pager_days est calculée en ajoutant les valeurs représentant les jours voulus. Par exemple, la valeur définissant un envoi du lundi au vendredi est calculée de la façon suivante : 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 réseau. netsend_addressest de type nvarchar(100), avec NULL comme valeur par défaut.
[ @category\_name=\] 'category'
Nom de la catégorie pour cette alerte. category est de type sysname, avec NULL comme valeur par défaut.

Valeur	Description
1	Dimanche
2	Lundi
4	Mardi
8	Mercredi
16	Jeudi
32	Vendredi
64	Samedi

Valeurs des codes de retour

0 (réussite) ou 1 (échec)

Notes

sp_update_operator doit être exécuté à 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 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 8h00 à 17h00) 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 = 64 ;
GO