sp_apply_job_to_targets (Transact-SQL)sp_apply_job_to_targets (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

1 つ以上のターゲット サーバー、または 1 つ以上のターゲット サーバー グループに属する複数のターゲット サーバーにジョブを適用します。Applies a job to one or more target servers or to the target servers belonging to one or more target server groups.

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

構文Syntax

  
sp_apply_job_to_targets { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }  
     [ , [ @target_server_groups = ] 'target_server_groups' ]   
     [ , [ @target_servers = ] 'target_servers' ]   
     [ , [ @operation = ] 'operation' ]   

引数Arguments

[ @job_id = ] job_id 指定した対象サーバーまたは対象サーバー グループに適用するジョブのジョブ識別番号。[ @job_id = ] job_id The job identification number of the job to apply to the specified target servers or target server groups. job_iduniqueidentifier、既定値は NULL です。job_id is uniqueidentifier, with a default of NULL.

[ @job_name = ] 'job_name' 関連付けられている対象サーバーを指定された適用またはサーバー グループを対象とするジョブの名前。[ @job_name = ] 'job_name' The name of the job to apply to the specified the associated target servers or target server groups. job_namesysname、既定値は NULL です。job_name is sysname, with a default of NULL.

注意

いずれかjob_idまたはjob_name指定する必要がありますが、両方を指定することはできません。Either job_id or job_name must be specified, but both cannot be specified.

[ @target_server_groups = ] 'target_server_groups' 指定したジョブが適用される対象サーバー グループのコンマ区切りの一覧。[ @target_server_groups = ] 'target_server_groups' A comma-separated list of target server groups to which the specified job is to be applied. target_server_groupsnvarchar (2048) 、既定値は NULL です。target_server_groups is nvarchar(2048), with a default of NULL.

[ @target_servers = ] 'target_servers' 指定したジョブが適用される対象サーバーのコンマ区切りの一覧。[ @target_servers = ] 'target_servers' A comma-separated list of target servers to which the specified job is to be applied. target_serversnvarchar (2048) 、既定値は NULL です。target_serversis nvarchar(2048), with a default of NULL.

[ @operation = ] 'operation' 指定したジョブに適用または指定した対象サーバーまたは対象サーバー グループから削除するかどうか。[ @operation = ] 'operation' Is whether the specified job should be applied to or removed from the specified target servers or target server groups. 操作varchar (7) 、既定値は APPLY です。operationis varchar(7), with a default of APPLY. 有効な操作は適用削除します。Valid operations are APPLY and REMOVE.

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

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

コメントRemarks

sp_apply_job_to_targetsジョブを適用する (または削除する) 複数の対象サーバーからの簡単な方法を提供しを呼び出す代わりには、 sp_add_jobserver (またはsp_delete_jobserver)各対象サーバーが必要ですに対して 1 回。sp_apply_job_to_targets provides an easy way to apply (or remove) a job from multiple target servers, and is an alternative to calling sp_add_jobserver (or sp_delete_jobserver) once for each target server required.

アクセス許可Permissions

メンバーのみ、 sysadmin固定サーバー ロールは、このプロシージャを実行できます。Only members of the sysadmin fixed server role can execute this procedure.

使用例Examples

次の例では、Backup Customer Information グループのすべての対象サーバーに、先に作成した Servers Maintaining Customer Information ジョブを適用します。The following example applies the previously created Backup Customer Information job to all the target servers in the Servers Maintaining Customer Information group.

USE msdb ;  
GO  
  
EXEC dbo.sp_apply_job_to_targets  
    @job_name = N'Backup Customer Information',  
    @target_server_groups = N'Servers Maintaining Customer Information',   
    @operation = N'APPLY' ;  
GO  

参照See Also

sp_add_jobserver (TRANSACT-SQL) sp_add_jobserver (Transact-SQL)
sp_delete_jobserver (TRANSACT-SQL) sp_delete_jobserver (Transact-SQL)
sp_remove_job_from_targets (TRANSACT-SQL) sp_remove_job_from_targets (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)