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,其值必须介于 0127 之间。将所需的那些天对应的各个数值相加即可算出 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 固定服务器角色的成员执行此过程的权限。

示例

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

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)

帮助和信息

获取 SQL Server 2005 帮助