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