次の方法で共有


sp_update_operator (Transact-SQL)

警告およびジョブの使用に関するオペレーター (通知受信者) の情報を更新します。

トピック リンク アイコン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