sp_update_operator (Transact-SQL)
Gilt für: SQL Server
Aktualisiert Informationen zu einem Operator (Benachrichtigungsempfänger) für die Verwendung mit Warnungen und Aufträgen.
Transact-SQL-Syntaxkonventionen
Syntax
sp_update_operator
[ @name = ] N'name'
[ , [ @new_name = ] N'new_name' ]
[ , [ @enabled = ] enabled ]
[ , [ @email_address = ] N'email_address' ]
[ , [ @pager_address = ] N'pager_address' ]
[ , [ @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 = ] N'netsend_address' ]
[ , [ @category_name = ] N'category_name' ]
[ ; ]
Argumente
[ @name = ] N'name'
Der Name des zu ändernden Operators. @name ist "sysname" ohne Standard.
[ @new_name = ] N'new_name'
Der neue Name des Operators. Dieser Name muss eindeutig sein. @new_name ist "sysname" mit der Standardeinstellung "NULL
.
[ @enabled = ] aktiviert
Eine Zahl, die den aktuellen Status des Operators angibt (1
wenn dies zurzeit aktiviert ist, 0
andernfalls). @enabled ist winzig, mit einem Standardwert von NULL
. Wenn diese Option nicht aktiviert ist, empfängt ein Operator keine Benachrichtigungen.
[ @email_address = ] N'email_address'
Die E-Mail-Adresse des Operators. @email_address ist nvarchar(100), wobei die Standardeinstellung istNULL
. Diese Zeichenfolge wird direkt an das E-Mail-System übergeben.
[ @pager_address = ] N'pager_address'
Gibt die Pageradresse des Operators an. @pager_address ist nvarchar(100), wobei die Standardeinstellung istNULL
. Diese Zeichenfolge wird direkt an das E-Mail-System übergeben.
[ @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 int, mit einem Standardwert von NULL
, und muss in das Formular HHmmss
für die Verwendung mit einer 24-Stunden-Uhr eingegeben werden.
[ @weekday_pager_end_time = ] weekday_pager_end_time
Gibt die Zeit an, nach der eine Pagerbenachrichtigung nicht an den angegebenen Operator gesendet werden kann, von Montag bis Freitag. @weekday_pager_end_time ist int, mit einem Standardwert von NULL
, und muss in das Formular HHmmss
für die Verwendung mit einer 24-Stunden-Uhr 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 int, mit einem Standardwert von NULL
, und muss in das Formular HHmmss
für die Verwendung mit einer 24-Stunden-Uhr eingegeben werden.
[ @saturday_pager_end_time = ] saturday_pager_end_time
Gibt die Uhrzeit an, zu der eine Pager-Benachrichtigung am Samstag nicht an den angegebenen Operator gesendet werden kann. @saturday_pager_end_time ist int, mit einem Standardwert von NULL
, und muss in das Formular HHmmss
für die Verwendung mit einer 24-Stunden-Uhr 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 int, mit einem Standardwert von NULL
, und muss in das Formular HHmmss
für die Verwendung mit einer 24-Stunden-Uhr eingegeben werden.
[ @sunday_pager_end_time = ] sunday_pager_end_time
Gibt die Uhrzeit an, zu der eine Pager-Benachrichtigung am Sonntag nicht an den angegebenen Operator gesendet werden kann. @sunday_pager_end_time ist int, mit einem Standardwert von NULL
, und muss in das Formular HHmmss
für die Verwendung mit einer 24-Stunden-Uhr 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 winzig, mit einem Standardwert von NULL
, und muss ein Wert von 0
durch 127
. @pager_days wird berechnet, indem die einzelnen Werte für die erforderlichen Tage hinzugefügt werden. Beispiel: Von Montag bis Freitag ist 2
8
+ 16
+ 32
4
64
+ + = .
Wert | Beschreibung |
---|---|
1 |
Sonntag |
2 |
Montag |
4 |
Tuesday |
8 |
Mittwoch |
16 |
Donnerstag |
32 |
Freitag |
64 |
Samstag |
[ @netsend_address = ] N'netsend_address'
Die Netzwerkadresse des Operators, an die die Netzwerknachricht gesendet wird. @netsend_address ist "nvarchar(100)" mit der Standardeinstellung "NULL
.
[ @category_name = ] N'category_name'
Der Name der Kategorie für diese Warnung. @category_name ist "sysname" mit der Standardeinstellung "NULL
.
Rückgabecodewerte
0
(erfolgreich) 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, die Einstellung @enabled
auf true
und die Tage (von Montag bis Freitag, von 8:00 bis 17:00 Uhr) aktualisiert, wenn der Operator ausgelagert werden kann.
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