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

関連項目

参照

sp_add_operator (Transact-SQL)

sp_delete_operator (Transact-SQL)

sp_help_operator (Transact-SQL)

システム ストアド プロシージャ (Transact-SQL)