sp_update_operator (Transact-SQL)

Artikel
2025-01-02

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 28 + 16 + 32464 + + = .

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 trueund 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

Freigeben über