sp_update_operator (Transact-SQL)

發行項
06/18/2013

更新操作員 (通知收件者) 的相關資訊，以搭配警示和作業使用。

語法

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

引數

[ @name=\] 'name'
要修改的操作員名稱。 name 是 sysname，沒有預設值。
[ @new\_name=\] 'new_name'
操作員的新名稱。這個名稱必須是唯一的。 new_name 是 sysname，預設值是 NULL。
[ @enabled=\] enabled
這是指出操作員目前狀態的數字 (1 表示目前已啟用，0 表示目前未啟用)。 enabled 是 tinyint，預設值是 NULL。如果未啟用，操作員不會收到警示通知。
[ @email\_address=\] 'email_address'
操作員的電子郵件地址。這個字串會直接傳遞至電子郵件系統。 email_address 是 nvarchar(100)，預設值是 NULL。
[ @pager\_address=\] 'pager_number'
操作員的呼叫器號碼。這個字串會直接傳遞至電子郵件系統。 pager_number 是 nvarchar(100)，預設值是 NULL。
[ @weekday\_pager\_start\_time=\] weekday_pager_start_time
指定從星期一到星期五，在什麼時間之後，可以將呼叫器通知傳給這位操作員。 weekday_pager_start_time是 int，預設值是 NULL，且必須以 HHMMSS 格式輸入，以使用 24 小時制。
[ @weekday\_pager\_end\_time=\] weekday_pager_end_time
指定從星期一到星期五，在什麼時間之後，不能將呼叫器通知傳給指定的操作員。 weekday_pager_end_time是 int，預設值是 NULL，且必須以 HHMMSS 格式輸入，以使用 24 小時制。
[ @saturday\_pager\_start\_time=\] saturday_pager_start_time
指定在星期六的什麼時間之後，可以將呼叫器通知傳給指定的操作員。 saturday_pager_start_time是 int，預設值是 NULL，且必須以 HHMMSS 格式輸入，以使用 24 小時制。
[ @saturday\_pager\_end\_time=\] saturday_pager_end_time
指定在星期六的什麼時間之後，不能將呼叫器通知傳給指定的操作員。 saturday_pager_end_time是 int，預設值是 NULL，且必須以 HHMMSS 格式輸入，以使用 24 小時制。
[ @sunday\_pager\_start\_time=\] sunday_pager_start_time
指定在星期日的什麼時間之後，可以將呼叫器通知傳給指定的操作員。 sunday_pager_start_time是 int，預設值是 NULL，且必須以 HHMMSS 格式輸入，以使用 24 小時制。
[ @sunday\_pager\_end\_time=\] sunday_pager_end_time
指定在星期日的什麼時間之後，不能將呼叫器通知傳給指定的操作員。 sunday_pager_end_time是 int，預設值是 NULL，且必須以 HHMMSS 格式輸入，以使用 24 小時制。
[ @pager\_days=\] pager_days
指定操作員能夠接收呼叫的日子 (遵照指定的開始/結束時間)。 pager_days是 tinyint，預設值是 NULL，而且必須是從 0 到 127 的值。 pager_days 的計算方式是加入必要日的個別值。例如，從星期一到星期五是 2+4+8+16+32 = 64。

值

說明

1

星期日

2

星期一

4

星期二

8

星期三

16

星期四

32

星期五

64

星期六
[ @netsend\_address=\] 'netsend_address'
要傳送網路訊息的目標操作員網路位址。 netsend_address是 nvarchar(100)，預設值是 NULL。
[ @category\_name=\] 'category'
這個警示的類別目錄名稱。 category 是 sysname，預設值是 NULL。

值	說明
1	星期日
2	星期一
4	星期二
8	星期三
16	星期四
32	星期五
64	星期六

傳回碼值

0 (成功) 或 1 (失敗)

備註

sp_update_operator 必須從 msdb 資料庫中執行。

權限

這個程序的執行權限預設會授與系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

下列範例會將操作員狀態更新為已啟用，並設定能夠呼叫操作員的日子 (星期一至星期五，上午 8 點至下午 5 點)。

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