sp_update_operator

更新警报和作业所用的操作员（提示接收人）信息。

语法

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

是表示操作员当前状态的数字（若当前已启用，其值为１，若当前未启用，其值为０）。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，且必须以 24 小时时钟的 HHMMSS 格式输入。

[@weekday_pager_end_time =] weekday_pager_end_time

指定从星期一到星期五可向指定操作员发送呼叫提示的终止时间。weekday_pager_end_time 的数据类型为 int，其默认值为 NULL，且必须以 24 小时时钟的 HHMMSS 格式输入。

[@saturday_pager_start_time =] saturday_pager_start_time

指定在星期六可向指定操作员发送呼叫提示的起始时间。saturday_pager_start_time 的数据类型为 int，其默认值为 NULL，且必须以 24 小时时钟的 HHMMSS 格式输入。

[@saturday_pager_end_time =] saturday_pager_end_time

指定在星期六可向指定操作员发送呼叫提示的终止时间。saturday_pager_end_time 的数据类型为 int，其默认值为 NULL，且必须以 24 小时时钟的 HHMMSS 格式输入。

[@sunday_pager_start_time =] sunday_pager_start_time

指定在星期日可向指定操作员发送呼叫提示的起始时间。sunday_pager_start_time 的数据类型为 int，其默认值为 NUL，且必须以 24 小时时钟的 HHMMSS 格式输入。

[@sunday_pager_end_time =] sunday_pager_end_time

指定在星期日可向指定操作员发送呼叫提示的终止时间。sunday_pager_end_time 的数据类型为 int，其默认值为 NULL，且必须以 24 小时时钟的 HHMMSS 格式输入。

[@pager_days =] pager_days

指定一星期中哪些天操作员可以接收呼叫（局限于指定的起始/终止时间）。pager_days 的数据类型为 tinyint，其默认值为 NULL，且必须介于 0 至 127 之间。pager_days 通过将所需的那些天对应的单个数值逐个相加而得到。例如，从星期一到星期五为 2+4+8+16+32 = 62。

值	描述
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 固定服务器角色的成员才能执行 sp_update_operator。

示例

下例将操作员状态更新为启用，并设置可以呼叫该操作员的时间（星期一至星期五，早上八点至下午五点）。

USE msdb
EXEC sp_update_operator @name = 'Steven Buchanan', @enabled = 1,
   @email_address = 'stevenb',
   @pager_address = '5673218@mypagerco.com', 
   @weekday_pager_start_time = 080000, 
   @weekday_pager_end_time = 170000, 
   @pager_days = 62

请参见