sp_update_operator (Transact-SQL)
Aktualisiert Informationen zu einem Operator (Benachrichtigungsempfänger) für die Verwendung mit Warnungen und Aufträgen.
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 Operators, der geändert werden soll. name ist ein Wert vom Datentyp sysname und weist keinen Standardwert auf.
[ @new_name =] 'new_name'
Der neue Name des Operators. Dieser Name muss eindeutig sein. new_name ist ein Wert vom Datentyp sysname; der Standardwert ist NULL.
[ @enabled =] enabled
Eine Zahl, die auf den aktuellen Status des Operators verweist (1, wenn derzeit aktiviert, andernfalls 0). enabled ist ein Wert 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 ein Wert vom Datentyp nvarchar(100); der Standardwert ist NULL.
[ @pager_address =] 'pager_number'
Die Pageradresse des Operators. Diese Zeichenfolge wird direkt an das E-Mail-System weitergegeben. pager_number ist ein Wert 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_time ist ein Wert 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 keine Pagerbenachrichtigung an den angegebenen Operator gesendet werden kann. weekday_pager_end_time ist ein Wert 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_time ist ein Wert 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 keine Pagerbenachrichtigung an den angegebenen Operator gesendet werden kann. saturday_pager_end_time ist ein Wert 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_time ist ein Wert 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 keine Pagerbenachrichtigung an den angegebenen Operator gesendet werden kann. sunday_pager_end_time ist ein Wert 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_days ist ein Wert vom Datentyp tinyint; der Standardwert ist NULL. Der Wert muss zwischen 0 und 127 liegen. pager_days wird berechnet, indem die einzelnen Werte für die erforderlichen Tage addiert werden. 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 den die Netzwerknachricht gesendet wird. netsend_address ist ein Wert vom Datentyp nvarchar(100); der Standardwert ist NULL.
[ @category_name =] 'category'
Der Name der Kategorie für diese Warnung. category ist ein Wert vom Datentyp sysname; der Standardwert ist NULL.
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 = 62 ;
GO
Siehe auch
Verweis
sp_add_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)
sp_help_operator (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)