sp_update_operator (Transact-SQL)

Artikel
06/18/2013

Aktualisiert Informationen zu einem Operator (Benachrichtigungsempfänger) für die Verwendung mit Warnungen und Aufträgen.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @name=\] 'name'
Der Name des zu ändernden Operators. name ist vom Datentyp sysname und hat keinen Standardwert.
[ @new\_name=\] 'new_name'
Der neue Name des Operators. Dieser Name muss eindeutig sein. new_name ist vom Datentyp sysname. Der Standardwert ist NULL.
[ @enabled=\] enabled
Eine Zahl, die auf den aktuellen Status des Operators verweist (1, wenn derzeit aktiviert, 0 wenn deaktiviert). enabled ist vom Datentyp tinyint. Der Standardwert ist NULL. Bei deaktivierter Option empfängt der Operator keine Warnbenachrichtigungen.
[ @email\_address=\] 'email_address'
Die E-Mail-Adresse des Operators. Diese Zeichenfolge wird direkt an das E-Mail-System übergeben. email_address ist vom Datentyp nvarchar(100). Der Standardwert ist NULL.
[ @pager\_address=\] 'pager_number'
Gibt die Pageradresse des Operators an. Diese Zeichenfolge wird direkt an das E-Mail-System übergeben. pager_number ist vom Datentyp nvarchar(100). Der Standardwert ist NULL.
[ @weekday\_pager\_start\_time=\] weekday_pager_start_time
Gibt die Uhrzeit an, nach der von Montag bis Freitag eine Pagerbenachrichtigung an diesen Operator gesendet werden kann. weekday_pager_start_timeist vom Datentyp int; der Standardwert ist NULL. Der Wert muss im Format HHMMSS für das 24-Stunden-System eingegeben werden.
[ @weekday\_pager\_end\_time=\] weekday_pager_end_time
Gibt die Uhrzeit an, nach der von Montag bis Freitag eine Pagerbenachrichtigung nicht an den angegebenen Operator gesendet werden kann. weekday_pager_end_timeist vom Datentyp int; der Standardwert ist NULL. Der Wert muss im Format HHMMSS für das 24-Stunden-System eingegeben werden.
[ @saturday\_pager\_start\_time=\] saturday_pager_start_time
Gibt die Uhrzeit an, nach der samstags eine Pagerbenachrichtigung an den angegebenen Operator gesendet werden kann. saturday_pager_start_timeist vom Datentyp int; der Standardwert ist NULL. Der Wert muss im Format HHMMSS für das 24-Stunden-System eingegeben werden.
[ @saturday\_pager\_end\_time=\] saturday_pager_end_time
Gibt die Uhrzeit an, nach der samstags eine Pagerbenachrichtigung nicht an den angegebenen Operator gesendet werden kann. saturday_pager_end_timeist vom Datentyp int; der Standardwert ist NULL. Der Wert muss im Format HHMMSS für das 24-Stunden-System eingegeben werden.
[ @sunday\_pager\_start\_time=\] sunday_pager_start_time
Gibt die Uhrzeit an, nach der sonntags eine Pagerbenachrichtigung an den angegebenen Operator gesendet werden kann. sunday_pager_start_timeist vom Datentyp int; der Standardwert ist NULL. Der Wert muss im Format HHMMSS für das 24-Stunden-System eingegeben werden.
[ @sunday\_pager\_end\_time=\] sunday_pager_end_time
Gibt die Uhrzeit an, nach der sonntags eine Pagerbenachrichtigung nicht an den angegebenen Operator gesendet werden kann. sunday_pager_end_timeist vom Datentyp int; der Standardwert ist NULL. Der Wert muss im Format HHMMSS für das 24-Stunden-System eingegeben werden.
[ @pager\_days=\] pager_days
Gibt an, an welchen Tagen der Operator für den Empfang von Seiten zur Verfügung steht (vorbehaltlich der angegebenen Start-/Beendigungszeiten). pager_daysist vom Datentyp tinyint. Der Standardwert ist NULL, und mögliche Werte liegen zwischen 0 und 127. pager_days wird durch Addition der einzelnen Werte für die erforderlichen Tage berechnet. Beispielsweise werden die Tage Montag bis Freitag folgendermaßen berechnet: 2+4+8+16+32 = 64.

Wert

Beschreibung

1

Sonntag

2

Montag

4

Dienstag

8

Mittwoch

16

Donnerstag

32

Freitag

64

Samstag
[ @netsend\_address=\] 'netsend_address'
Die Netzwerkadresse des Operators, an die die Netzwerknachricht gesendet wird. netsend_addressist vom Datentyp nvarchar(100). Der Standardwert ist NULL.
[ @category\_name=\] 'category'
Der Name der Kategorie für diese Warnung. category ist ein vom Datentyp sysname. Der Standardwert ist NULL.

Wert	Beschreibung
1	Sonntag
2	Montag
4	Dienstag
8	Mittwoch
16	Donnerstag
32	Freitag
64	Samstag

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_update_operator muss aus der msdb-Datenbank ausgeführt werden.

Berechtigungen

Berechtigungen zur Ausführung dieser Prozedur erhalten standardmäßig Mitglieder der festen Serverrolle sysadmin.

Beispiele

Im folgenden Beispiel wird der Operatorstatus zu 'enabled' aktualisiert und die Tage festgelegt (von Montag bis Freitag, 8:00 Uhr bis 17:00 Uhr), an denen der Operator per Pager erreichbar ist.

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