sp_update_operator (Transact-SQL)
適用於:SQL Server
更新操作員 (通知收件者) 的相關信息,以搭配警示和作業使用。
語法
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' ]
[ ; ]
引數
[ @name = ] N'name'
要修改的運算子名稱。 @name為 sysname,沒有預設值。
[ @new_name = ] N'new_name'
運算子的新名稱。 這個名稱必須是唯一的。 @new_name為 sysname,預設值為 NULL
。
[ @enabled = ] enabled
數位,指出運算子的目前狀態(1
如果目前已啟用, 0
如果沒有的話)。 @enabled為 tinyint,預設值為 NULL
。 如果未啟用,操作員就不會收到警示通知。
[ @email_address = ] N'email_address'
操作員的電子郵件位址。 @email_address為 nvarchar(100),預設值為 NULL
。 此字串會直接傳遞至電子郵件系統。
[ @pager_address = ] N'pager_address'
運算子的呼叫器位址。 @pager_address為 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
= + + 64
32
16
4
8
+ + 。
值 | Description |
---|---|
1 |
星期日 |
2 |
星期一 |
4 |
Tuesday |
8 |
星期三 |
16 |
Thursday |
32 |
星期五 |
64 |
星期六 |
[ @netsend_address = ] N'netsend_address'
傳送網路訊息之操作員的網路位址。 @netsend_address為 nvarchar(100),預設值為 NULL
。
[ @category_name = ] N'category_name'
此警示的類別名稱。 @category_name為 sysname,預設值為 NULL
。
傳回碼值
0
(成功) 或 1
(失敗)。
備註
sp_update_operator
必須從 msdb
資料庫執行。
權限
這個程序的執行權限預設會授與 系統管理員 (sysadmin) 固定伺服器角色的成員。
範例
下列範例會更新操作員狀態、將 設定 @enabled
為 true
,並將日期(從星期一到星期五,從上午 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