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.

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 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 que puede enviarse una notificación por localizador a este operador, de lunes a viernes. weekday_pager_start_timees 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 localizador al operador especificado, de lunes a viernes. weekday_pager_end_timees 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_timees 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 localizador al operador especificado, los sábados. saturday_pager_end_timees 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_timees 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 localizador al operador especificado, los domingos. sunday_pager_end_timees 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_dayses de tipo tinyint, su valor predeterminado es NULL y debe ser un valor del 0 al 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.

[ @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.

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.

Valores de código de retorno

0 (correcto) o 1 (error)

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

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)

Ayuda e información

Obtener ayuda sobre SQL Server 2005