sp_update_operator (Transact-SQL)
更新操作員 (通知收件者) 的相關資訊，以使用警示和作業。
語法
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。
傳回碼值
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 = 62 ;
GO
請參閱
參考
sp_add_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)
sp_help_operator (Transact-SQL)
系統預存程序 (Transact-SQL)