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 = 64 ;
GO

関連項目

参照