sp_update_operator (Transact-SQL)

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 und hat den Standardwert 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) und weist den Standardwert NULL auf.

  • [ @pager_address =] 'pager_number'
    Die Pageradresse des Operators. Diese Zeichenfolge wird direkt an das E-Mail-System übergeben. pager_number ist ein Wert vom Datentyp nvarchar(100) und weist den Standardwert NULL auf.

  • [ @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 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 eine Pagerbenachrichtigung nicht an den angegebenen Operator gesendet werden kann. weekday_pager_end_timeist 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_timeist 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 eine Pagerbenachrichtigung nicht an den angegebenen Operator gesendet werden kann. saturday_pager_end_timeist 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_timeist 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 eine Pagerbenachrichtigung nicht an den angegebenen Operator gesendet werden kann. sunday_pager_end_timeist 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_daysist 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. Beispiel: Die Angabe von Montag bis Freitag lautet 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_addressist ein Wert vom Datentyp nvarchar(100) und weist den Standardwert NULL auf.

  • [ @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 = 64 ;
GO