sp_update_operator (Transact-SQL)

项目
12/22/2023

更新警报和作业所用的操作员（通知收件人）信息。

语法

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为 @weekday_pager_end_time，必须以表单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 。例如，从星期一到星期五是 28 + 16 + 32464 + + = 。

值	说明
`1`	星期日
`2`	星期一
`4`	星期二
`8`	星期三
`16`	星期四
`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