sp_update_operator (Transact-SQL)sp_update_operator (Transact-SQL)

適用対象: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

警告とジョブで使用するためには、オペレーター (通知受信者) に関する情報を更新します。Updates information about an operator (notification recipient) for use with alerts and jobs.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

  
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' ]  

引数Arguments

[ @name=] '名前'[ @name=] 'name'
変更するオペレーターの名前を指定します。The name of the operator to modify. 名前sysname、既定値はありません。name is sysname, with no default.

[ @new_name=] 'new_name'[ @new_name=] 'new_name'
演算子の新しい名前。The new name for the operator. この名前は一意である必要があります。This name must be unique. 新しい名前sysname、既定値は NULL です。new_name is sysname, with a default of NULL.

[ @enabled=] enabled[ @enabled=] enabled
オペレーターの現在の状態を示す数値 (1現在有効になっている場合0いない場合)。A number indicating the operator's current status (1 if currently enabled, 0 if not). 有効になっているtinyint、既定値は NULL です。enabled is tinyint, with a default of NULL. 有効でない場合、オペレーターは警告通知を受信しません。If not enabled, an operator will not receive alert notifications.

[ @email_address=] 'email_address'[ @email_address=] 'email_address'
オペレーターの電子メール アドレス。The e-mail address of the operator. この文字列はメール システムに直接渡されます。This string is passed directly to the e-mail system. email_addressnvarchar (100) 、既定値は NULL です。email_address is nvarchar(100), with a default of NULL.

[ @pager_address=] 'pager_number'[ @pager_address=] 'pager_number'
オペレーターのポケットベル アドレス。The pager address of the operator. この文字列はメール システムに直接渡されます。This string is passed directly to the e-mail system. pager_numbernvarchar (100) 、既定値は NULL です。pager_number is nvarchar(100), with a default of NULL.

[ @weekday_pager_start_time=] weekday_pager_start_time[ @weekday_pager_start_time=] weekday_pager_start_time
ポケットベルによる通知できますを開始する、このオペレーターを月曜日から金曜日までから時間を指定します。Specifies the time after which a pager notification can be sent to this operator, from Monday through Friday. weekday_pager_start_timeint、既定値は null の場合、24 時間制の hhmmss で入力する必要があります。weekday_pager_start_timeis int, with a default of NULL, and must be entered in the form HHMMSS for use with a 24-hour clock.

[ @weekday_pager_end_time=] weekday_pager_end_time[ @weekday_pager_end_time=] weekday_pager_end_time
月曜日から金曜日までの間で、指定したオペレーターに対してポケットベル通知を終了する時間を指定します。Specifies the time after which a pager notification cannot be sent to the specified operator, from Monday through Friday. エージェントint、既定値は null の場合、24 時間制の hhmmss で入力する必要があります。weekday_pager_end_timeis int, with a default of NULL, and must be entered in the form HHMMSS for use with a 24-hour clock.

[ @saturday_pager_start_time=] saturday_pager_start_time[ @saturday_pager_start_time=] saturday_pager_start_time
ポケットベルによる通知できますを開始する指定したオペレーターに対して毎週土曜日の時間を指定します。Specifies the time after which a pager notification can be sent to the specified operator on Saturdays. エージェントint、既定値は null の場合、24 時間制の hhmmss で入力する必要があります。saturday_pager_start_timeis int, with a default of NULL, and must be entered in the form HHMMSS for use with a 24-hour clock.

[ @saturday_pager_end_time=] saturday_pager_end_time[ @saturday_pager_end_time=] saturday_pager_end_time
ポケットベルによる通知できませんを開始する指定したオペレーターに対して毎週土曜日の時間を指定します。Specifies the time after which a pager notification cannot be sent to the specified operator on Saturdays. *@saturday_pager_end_time*は**int**、既定値は null の場合、24 時間制の hhmmss で入力する必要があります。saturday_pager_end_timeis int, with a default of NULL, and must be entered in the form HHMMSS for use with a 24-hour clock.

[ @sunday_pager_start_time=] sunday_pager_start_time[ @sunday_pager_start_time=] sunday_pager_start_time
ポケットベルによる通知できますを開始する指定したオペレーターに対して毎週日曜日、時間を指定します。Specifies the time after which a pager notification can be sent to the specified operator on Sundays. エージェントint、既定値は null の場合、24 時間制の hhmmss で入力する必要があります。sunday_pager_start_timeis int, with a default of NULL, and must be entered in the form HHMMSS for use with a 24-hour clock.

[ @sunday_pager_end_time=] sunday_pager_end_time[ @sunday_pager_end_time=] sunday_pager_end_time
毎週日曜日に、指定したオペレーターに対してポケットベル通知を終了する時間を指定します。Specifies the time after which a pager notification cannot be sent to the specified operator on Sundays. エージェントint、既定値は null の場合、24 時間制の hhmmss で入力する必要があります。sunday_pager_end_timeis int, with a default of NULL, and must be entered in the form HHMMSS for use with a 24-hour clock.

[ @pager_days=] pager_days[ @pager_days=] pager_days
オペレーターがポケットベルの指定した開始/終了時間) を受信できる曜日を指定します。Specifies the days that the operator is available to receive pages (subject to the specified start/end times). pager_daystinyint、既定値は null の場合、値を指定する必要がありますと0を通じて127pager_daysis tinyint, with a default of NULL, and must be a value from 0 through 127. pager_days必要となる曜日の個々 の値を加算して計算されます。pager_days is calculated by adding the individual values for the required days. たとえば、月曜日から金曜日までからは2+4+8+16 + 32 = 64します。For example, from Monday through Friday is 2+4+8+16+32 = 64.

Value 説明Description
11 日曜日Sunday
22 月曜日Monday
44 火曜日Tuesday
88 水曜日Wednesday
1616 木曜日Thursday
3232 金曜日Friday
6464 土曜日Saturday

[ @netsend_address=] 'netsend_address'[ @netsend_address=] 'netsend_address'
ネットワーク メッセージを送信するオペレーターのネットワーク アドレス。The network address of the operator to whom the network message is sent. netsend_addressnvarchar (100) 、既定値は NULL です。netsend_addressis nvarchar(100), with a default of NULL.

[ @category_name=] 'category'[ @category_name=] 'category'
このアラートのカテゴリの名前。The name of the category for this alert. categorysysname、既定値は NULL です。category is sysname, with a default of NULL.

リターン コードの値Return Code Values

0 (成功) または1 (失敗)0 (success) or 1 (failure)

コメントRemarks

sp_update_operator は、msdb データベースから実行する必要があります。sp_update_operator must be run from the msdb database.

アクセス許可Permissions

Sysadmin 固定サーバー ロールのメンバーにこのプロシージャの既定値を実行する権限。Permissions to execute this procedure default to members of the sysadmin fixed server role.

使用例Examples

次の例では、無効であったオペレーターの状態を有効に更新し、ポケットベルを受信できる曜日 (月曜~金曜日、The following example updates the operator status to enabled, and sets the days (from Monday through Friday, from 8 A.M. 午前 8 時~午後 5 時) を設定します。through 5 P.M.) when the operator can be paged.

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  

関連項目See Also

sp_add_operator (TRANSACT-SQL) sp_add_operator (Transact-SQL)
sp_delete_operator (TRANSACT-SQL) sp_delete_operator (Transact-SQL)
sp_help_operator (TRANSACT-SQL) sp_help_operator (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)