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. Значения нужно вводить в формате ЧЧММСС с использованием 24-часового формата времени.

• [ @weekday_pager_end_time =] weekday_pager_end_time
  Указывает время, после которого оператору запрещается направлять уведомления по пейджинговой связи, с понедельника по пятницу. Аргумент weekday_pager_end_time имеет тип int и значение по умолчанию NULL. Значения нужно вводить в формате ЧЧММСС с использованием 24-часового формата времени.

• [ @saturday_pager_start_time =] saturday_pager_start_time
  Указывает время, после которого данному оператору в субботу может быть направлено уведомление по пейджинговой связи. Аргумент saturday_pager_start_time имеет тип int и значение по умолчанию NULL. Значения нужно вводить в формате ЧЧММСС с использованием 24-часового формата времени.

• [ @saturday_pager_end_time =] saturday_pager_end_time
  Указывает время, после которого данному оператору в субботу запрещается направлять уведомления по пейджинговой связи. Аргумент saturday_pager_end_time имеет тип int и значение по умолчанию NULL. Значения нужно вводить в формате ЧЧММСС с использованием 24-часового формата времени.

• [ @sunday_pager_start_time =] sunday_pager_start_time
  Указывает время, после которого данному оператору в воскресенье может быть направлено уведомление по пейджинговой связи. Аргумент sunday_pager_start_time имеет тип int и значение по умолчанию NULL. Значения нужно вводить в формате ЧЧММСС с использованием 24-часового формата времени.

• [ @sunday_pager_end_time =] sunday_pager_end_time
  Указывает время, после которого данному оператору в воскресенье запрещается направлять уведомления по пейджинговой связи. Аргумент sunday_pager_end_time имеет тип int и значение по умолчанию NULL. Значения нужно вводить в формате ЧЧММСС с использованием 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.

Примеры

В следующем примере статус оператора изменяется на «включен» и назначается время, когда оператору можно передавать сообщения по пейджинговой связи (с понедельника по пятницу, с 8 до 17 часов).

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

См. также

Справочник