sp_update_operator (Transact-SQL)

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

Icona di collegamento a un argomentoConvenzioni 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. 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 è attivato, 0 in caso contrario). enabled è di tipo tinyint e il valore predefinito è NULL. Gli operatori non attivati 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 attivato. 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 = 62 ;
GO