sp_update_operator (Transact-SQL)

Articolo
06/18/2013

Aggiorna le informazioni relative a un operatore (destinatario di notifiche) utilizzate in avvisi e processi.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

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. Il nome deve essere 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 a 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.

Valore	Descrizione
1	Domenica
2	Lunedì
4	Martedì
8	Mercoledì
16	Giovedì
32	Venerdì
64	Sabato

Valori di codice restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_update_operator deve essere eseguita dal 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