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 temas Convenciones 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 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 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 los sábados al operador especificado. 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 no puede enviarse una notificación por buscapersonas los sábados al operador especificado. 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 los domingos al operador especificado. 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 no puede enviarse una notificación por buscapersonas los domingos al operador especificado. 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 que el operador está disponible para recibir mensajes por buscapersonas (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 comprendido entre 0 y 127. pager_days se calcula sumando los valores individuales de los días necesarios. 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'
    La 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'
    El 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 debe ejecutarse desde la base de datos msdb.

Permisos

Los permisos de ejecución de 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 8 a.m. a 5 p.m.) en que se le puede enviar una notificación por buscapersonas.

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

Vea también

Referencia

sp_add_operator (Transact-SQL)

sp_delete_operator (Transact-SQL)

sp_help_operator (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)