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 時間制の HHMMSS 形式で入力する必要があります。

• [ @weekday_pager_end_time =] weekday_pager_end_time
  月曜日から金曜日までの間で、指定したオペレータに対してポケットベル通知を終了する時間を指定します。weekday_pager_end_timeのデータ型は int で、既定値は NULL です。値は 24 時間制の HHMMSS 形式で入力する必要があります。

• [ @saturday_pager_start_time =] saturday_pager_start_time
  毎週土曜日に、指定したオペレータに対してポケットベル通知を開始する時間を指定します。saturday_pager_start_timeのデータ型は int で、既定値は NULL です。値は 24 時間制の HHMMSS 形式で入力する必要があります。

• [ @saturday_pager_end_time =] saturday_pager_end_time
  毎週土曜日に、指定したオペレータに対してポケットベル通知を終了する時間を指定します。saturday_pager_end_timeのデータ型は int で、既定値は NULL です。値は 24 時間制の HHMMSS 形式で入力する必要があります。

• [ @sunday_pager_start_time =] sunday_pager_start_time
  毎週日曜日に、指定したオペレータに対してポケットベル通知を開始する時間を指定します。sunday_pager_start_timeのデータ型は int で、既定値は NULL です。値は 24 時間制の HHMMSS 形式で入力する必要があります。

• [ @sunday_pager_end_time =] sunday_pager_end_time
  毎週日曜日に、指定したオペレータに対してポケットベル通知を終了する時間を指定します。sunday_pager_end_timeのデータ型は int で、既定値は NULL です。値は 24 時間制の HHMMSS 形式で入力する必要があります。

• [ @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 時～午後 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 = 62 ;
GO

関連項目

参照