sp_update_operator (Transact-SQL)
Aggiorna le informazioni relative a un operatore (destinatario di notifiche) utilizzate in avvisi e processi.
.gif "Icona di collegamento a un argomento")
Sintassi
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' ]
Argomenti
[ @name =] 'name'
Nome dell'operatore da modificare. name è di tipo sysname e non prevede alcun valore predefinito.[ @new_name =] 'new_name'
Nuovo nome dell'operatore. Deve essere un nome univoco. new_name è di tipo sysname e il valore predefinito è NULL.[ @enabled =] enabled
Numero che indica lo stato corrente dell'operatore (1 se è abilitato, 0 in caso contrario). enabled è di tipo tinyint e il valore predefinito è NULL. Gli operatori non abilitati non ricevono le notifiche di avviso.[ @email_address =] 'email_address'
Indirizzo di posta elettronica dell'operatore. Questa stringa viene passata direttamente al sistema di posta elettronica. email_address è di tipo nvarchar(100) e il valore predefinito è NULL.[ @pager_address =] 'pager_number'
Indirizzo del cercapersone dell'operatore. Questa stringa viene passata direttamente al sistema di posta elettronica. pager_number è di tipo nvarchar(100) e il valore predefinito è NULL.[ @weekday_pager_start_time =] weekday_pager_start_time
Indica l'ora dei giorni lavorativi da lunedì a venerdì oltre la quale è possibile inviare una notifica al cercapersone dell'operatore specificato. weekday_pager_start_time è di tipo int e il valore predefinito è NULL. Deve seguire la forma HHMMSS in base al formato a 24 ore.[ @weekday_pager_end_time =] weekday_pager_end_time
Indica l'ora dei giorni lavorativi da lunedì a venerdì oltre la quale non è possibile inviare una notifica al cercapersone dell'operatore specificato. weekday_pager_end_time è di tipo int e il valore predefinito è NULL. Deve seguire la forma HHMMSS in base al formato a 24 ore.[ @saturday_pager_start_time =] saturday_pager_start_time
Indica l'ora del sabato oltre la quale è possibile inviare una notifica sul cercapersone dell'operatore specificato. saturday_pager_start_time è di tipo int e il valore predefinito è NULL. Deve seguire la forma HHMMSS in base al formato a 24 ore.[ @saturday_pager_end_time =] saturday_pager_end_time
Indica l'ora del sabato oltre la quale non è possibile inviare una notifica sul cercapersone dell'operatore specificato. saturday_pager_end_time è di tipo int e il valore predefinito è NULL. Deve seguire la forma HHMMSS in base al formato a 24 ore.[ @sunday_pager_start_time =] sunday_pager_start_time
Indica l'ora della domenica oltre la quale è possibile inviare una notifica sul cercapersone dell'operatore specificato. sunday_pager_start_time è di tipo int e il valore predefinito è NULL. Deve seguire la forma HHMMSS in base al formato a 24 ore.[ @sunday_pager_end_time =] sunday_pager_end_time
Indica l'ora della domenica oltre la quale non è possibile inviare una notifica sul cercapersone dell'operatore specificato. sunday_pager_end_time è di tipo int e il valore predefinito è NULL. Deve seguire la forma HHMMSS in base al formato a 24 ore.[ @pager_days =pager_days]
Indica i giorni in cui l'operatore può essere rintracciato tramite cercapersone (in base all'ora di inizio e fine specificata). pager_days è di tipo tinyint e il valore predefinito è NULL. Deve essere compreso tra 0 e 127. pager_days viene calcolato sommando i singoli valori dei giorni necessari. Il valore per specificare i giorni da lunedì a venerdì, ad esempio, corrisponde alla somma 2+4+8+16+32 = 64.Valore
Descrizione
1
Domenica
2
Lunedì
4
Martedì
8
Mercoledì
16
Giovedì
32
Venerdì
64
Sabato
[ @netsend_address =] 'netsend_address'
Indirizzo di rete dell'operatore a cui viene inviato il messaggio di rete. netsend_address è di tipo nvarchar(100) e il valore predefinito è NULL.[ @category_name =] 'category'
Nome della categoria di questo avviso. category è di tipo sysname e il valore predefinito è NULL.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Osservazioni
La stored procedure sp_update_operator deve essere eseguita nel database msdb.
Autorizzazioni
Le autorizzazioni di esecuzione per questa procedura vengono assegnate per impostazione predefinita ai membri del ruolo predefinito del server sysadmin.
Esempi
Nell'esempio seguente lo stato dell'operatore viene impostato su abilitato. Vengono inoltre impostati i giorni in cui è possibile contattare l'operatore sul cercapersone, ovvero da lunedì a venerdì, dalle 8 alle 17.
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