sp_update_operator (Transact-SQL)

Sintaxe

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']

Argumentos

• [ @name =] 'name'
  O nome do operador a ser modificado. name é sysname, sem nenhum padrão.

• [ @new_name =] 'new_name'
  O novo nome para o operador. Esse nome da deve ser exclusivo. new_name é sysname, com um padrão NULL.

• [ @enabled =] enabled
  Um número indicando o status atual do operador (1 se estiver atualmente habilitado, 0 se não estiver). enabled é tinyint, com um padrão NULL. Se não estiver habilitado, um operador não receberá notificações de alerta.

• [ @email_address =] 'email_address'
  O endereço de email do operador. Essa cadeia de caracteres é passada diretamente ao sistema de email. email_address é nvarchar(100), com um padrão NULL.

• [ @pager_address =] 'pager_number'
  O endereço de pager do operador. Essa cadeia de caracteres é passada diretamente ao sistema de email. pager_number é nvarchar(100), com um padrão NULL.

• [ @weekday_pager_start_time =] weekday_pager_start_time
  Especifica a hora depois da qual uma notificação de pager pode ser enviada a esse operador, de segunda-feira a sexta-feira. weekday_pager_start_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.

• [ @weekday_pager_end_time =] weekday_pager_end_time
  Especifica a hora depois da qual uma notificação de pager não pode ser enviada ao operador especificado, de segunda-feira a sexta-feira. weekday_pager_end_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.

• [ @saturday_pager_start_time =] saturday_pager_start_time
  Especifica a hora depois da qual uma notificação de pager pode ser enviada ao operador nos sábados. saturday_pager_start_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.

• [ @saturday_pager_end_time =] saturday_pager_end_time
  Especifica a hora depois da qual uma notificação de pager não pode ser enviada ao operador nos sábados. saturday_pager_end_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.

• [ @sunday_pager_start_time =] sunday_pager_start_time
  Especifica a hora depois da qual uma notificação de pager pode ser enviada ao operador nos domingos. sunday_pager_start_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.

• [ @sunday_pager_end_time =] sunday_pager_end_time
  Especifica a hora depois da qual uma notificação de pager não pode ser enviada ao operador nos domingos. sunday_pager_end_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.

• [ @ pager_days =] pager_days
  Especifica os dias em que o operador está disponível para receber notificações por pager (sujeitos aos horários de início/término especificados). pager_daysé tinyint, com um padrão NULL, e seu valor deve ser de 0 a 127. pager_days é calculado adicionando os valores individuais para os dias necessários. Por exemplo, de segunda-feira a sexta-feira é 2+4+8+16+32 = 64.

  Valor	Descrição
  1	Domingo
  2	Segunda-feira
  4	Terça-feira
  8	Quarta-feira
  16	Quinta-feira
  32	Sexta-feira
  64	Sábado

• [ @netsend_address =] 'netsend_address'
  É o endereço de rede do operador ao qual a mensagem de rede é enviada. netsend_addressé nvarchar(100), com um padrão NULL.

• [ @category_name =] 'category'
  O nome da categoria para esse alerta. category é sysname, com um padrão NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_update_operator deve ser executado a partir do banco de dados msdb.

Permissões

As permissões para executar este procedimento usam como padrão membros da função de servidor fixa sysadmin.

Exemplos

O exemplo a seguir atualiza o status do operador para habilitado e define os dias (de segunda-feira a sexta-feira, das 8:00 às 17:00) quando o operador pode ser notificado por pager.

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

Consulte também

Referência