Partager via


sp_update_operator (Transact-SQL)

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

Icône Lien de rubriqueConventions 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, 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