sp_update_operator （Transact-SQL）

  • 發行項

適用於：SQL Server

更新 操作員（通知收件者）的相關信息，以便與警示和作業搭配使用。

Transact-SQL 語法慣例

語法

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 = + + 64321648 + + 。

值 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

相關內容