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 です。
解説
sp_update_operator は、msdb データベースから実行する必要があります。
権限
このプロシージャの実行権限は、既定では sysadmin 固定サーバー ロールのメンバに与えられています。
戻り値
0 (成功) または 1 (失敗)
例
次の例では、無効であったオペレータの状態を有効に更新し、ポケットベルを受信できる曜日 (月曜～金曜日、午前 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
参照
関連項目
sp_add_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)
sp_help_operator (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)