Compartir a través de


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'
    Nombre del operador que se va a modificar. name es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @new_name =] 'new_name'
    Nuevo nombre del operador. Este 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 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 buscapersonas 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 buscapersonas 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 buscapersonas 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 buscapersonas 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 buscapersonas 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 buscapersonas 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 buscapersonas 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_addresses 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)

Comentarios

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 del rol fijo 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 = 64 ;
GO