sp_update_operator (Transact-SQL)
適用対象: 
SQL サーバー
アラートとジョブで使用するオペレーター (通知受信者) に関する情報を更新します。
構文
sp_update_operator
[ @name = ] N'name'
[ , [ @new_name = ] N'new_name' ]
[ , [ @enabled = ] enabled ]
[ , [ @email_address = ] N'email_address' ]
[ , [ @pager_address = ] N'pager_address' ]
[ , [ @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 = ] N'netsend_address' ]
[ , [ @category_name = ] N'category_name' ]
[ ; ]
引数
[ @name = ] N'name'
変更するオペレーターの名前を指定します。 @name は sysname で、既定値はありません。
[ @new_name = ] N'new_name'
演算子の新しい名前。 この名前は一意である必要があります。 @new_name は sysname で、既定値は NULL です。
[ @enabled = ] enabled
オペレーターの現在の状態を示す数値 (現在有効になっている場合は1 、有効でない場合は 0 )。 @enabled は tinyint で、既定値は NULL です。 有効になっていない場合、オペレーターはアラート通知を受け取りません。
[ @email_address = ] N'email_address'
オペレーターの電子メール アドレス。 @email_address は nvarchar(100)で、既定値は NULL です。 この文字列はメール システムに直接渡されます。
[ @pager_address = ] N'pager_address'
演算子のポケットベル アドレス。 @pager_address は 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。
| Value | 説明 |
|---|---|
1 |
日曜日 |
2 |
月曜日 |
4 |
火曜日 |
8 |
水曜日 |
16 |
Thursday |
32 |
金曜日 |
64 |
土曜日 |
[ @netsend_address = ] N'netsend_address'
ネットワーク メッセージの送信先となるオペレーターのネットワーク アドレス。 @netsend_address は nvarchar(100) で、既定値は NULL です。
[ @category_name = ] N'category_name'
このアラートのカテゴリの名前。 @category_name は sysname で、既定値は NULL です。
リターン コードの値
0 (成功) または 1 (失敗)。
解説
sp_update_operator は、 msdb データベースから実行する必要があります。
アクセス許可
このプロシージャの実行権限は、既定では sysadmin 固定サーバー ロールのメンバーに与えられています。
例
次の例では、オペレーターの状態を更新し、 @enabled を true に設定し、オペレーターをページングできる曜日 (月曜日から金曜日の午前 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