sp_update_operator (Transact-SQL)

Actualiza información acerca de un operador (destinatario de la notificación) para utilizarla con las alertas y los trabajos.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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']

Argumentos

  • [ @name =] 'name'
    El nombre del operador que se va a modificar. name es de tipo sysname y no tiene valor predeterminado.

  • [ @new_name =] 'new_name'
    Nuevo nombre del operador. El nombre debe ser único. new_name es de tipo sysname y su valor predeterminado es NULL.

  • [ @enabled =] enabled
    Número que indica el estado actual del operador (1 si está habilitado, 0 si no lo está). enabled es de tipo tinyint y su valor predeterminado es NULL.Si no está habilitado, un operador no recibirá notificaciones de alertas.

  • [ @email_address =] 'email_address'
    Dirección de correo electrónico del operador. Esta cadena se pasa directamente al sistema de correo electrónico. email_address es de tipo nvarchar(100) y su valor predeterminado es NULL.

  • [ @pager_address =] 'pager_number'
    Dirección del localizador del operador. Esta cadena se pasa directamente al sistema de correo electrónico. pager_number es de tipo nvarchar(100) y su valor predeterminado es NULL.

  • [ @weekday_pager_start_time =] weekday_pager_start_time
    Especifica la hora a partir de la cual puede enviarse una notificación por localizador a este operador, de lunes a viernes. weekday_pager_start_time es de tipo int, su valor predeterminado es NULL y debe especificarse en el formato HHMMSS para utilizarse con un reloj de 24 horas.

  • [ @weekday_pager_end_time =] weekday_pager_end_time
    Especifica la hora a partir de la cual ya no puede enviarse una notificación por localizador al operador especificado, de lunes a viernes. weekday_pager_end_time es de tipo int, su valor predeterminado es NULL y debe especificarse en el formato HHMMSS para utilizarse con un reloj de 24 horas.

  • [ @saturday_pager_start_time =] saturday_pager_start_time
    Especifica la hora a partir de la cual puede enviarse una notificación por localizador al operador especificado, los sábados. saturday_pager_start_time es de tipo int, su valor predeterminado es NULL y debe especificarse en el formato HHMMSS para utilizarse con un reloj de 24 horas.

  • [ @saturday_pager_end_time =] saturday_pager_end_time
    Especifica la hora a partir de la cual ya no puede enviarse una notificación por localizador al operador especificado, los sábados. saturday_pager_end_time es de tipo int, su valor predeterminado es NULL y debe especificarse en el formato HHMMSS para utilizarse con un reloj de 24 horas.

  • [ @sunday_pager_start_time =] sunday_pager_start_time
    Especifica la hora a partir de la cual puede enviarse una notificación por localizador al operador especificado, los domingos. sunday_pager_start_time es de tipo int, su valor predeterminado es NULL y debe especificarse en el formato HHMMSS para utilizarse con un reloj de 24 horas.

  • [ @sunday_pager_end_time =] sunday_pager_end_time
    Especifica la hora a partir de la cual ya no puede enviarse una notificación por localizador al operador especificado, los domingos. sunday_pager_end_time es de tipo int, su valor predeterminado es NULL y debe especificarse en el formato HHMMSS para utilizarse con un reloj de 24 horas.

  • [ @pager_days =] pager_days
    Especifica los días en los que el operador está disponible para recibir mensajes por localizador (de acuerdo con las horas inicial y final especificadas). pager_days es de tipo tinyint, su valor predeterminado es NULL y debe ser un valor de 0 a 127. pager_days se calcula agregando los valores individuales de los días requeridos.Por ejemplo, de lunes a viernes es 2+4+8+16+32 = 64.

    Valor

    Descripción

    1

    Domingo

    2

    Lunes

    4

    Martes

    8

    Miércoles

    16

    Jueves

    32

    Viernes

    64

    Sábado

  • [ @netsend_address =] 'netsend_address'
    Dirección de red del operador al que se envía el mensaje de red. netsend_address es de tipo nvarchar(100) y su valor predeterminado es NULL.

  • [ @category_name =] 'category'
    Nombre de la categoría de esta alerta. category es de tipo sysname y su valor predeterminado es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

sp_update_operator se debe ejecutar desde la base de datos msdb.

Permisos

Los permisos de ejecución para este procedimiento corresponden de forma predeterminada a los miembros de la función fija de servidor sysadmin.

Ejemplos

En el ejemplo siguiente se actualiza el estado del operador a habilitado y se establecen los días (de lunes a viernes, de las 8 a.m. a las 5 p.m.) en los que se le puede enviar una notificación por localizador.

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