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,其值必须介于 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。
返回代码值
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)