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（失败）

注释

必须从 msdb 数据库运行 sp_update_operator。

权限

默认情况下授予 sysadmin 固定服务器角色的成员执行此过程的权限。

示例

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

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