sp_apply_job_to_targets (Transact-SQL)
適用対象: 
SQL Server
1 つ以上のターゲット サーバーまたは 1 つ以上のターゲット サーバー グループに属するターゲット サーバーにジョブを適用します。
構文
sp_apply_job_to_targets
[ [ @job_id = ] 'job_id' ]
[ , [ @job_name = ] N'job_name' ]
[ , [ @target_server_groups = ] N'target_server_groups' ]
[ , [ @target_servers = ] N'target_servers' ]
[ , [ @operation = ] 'operation' ]
[ ; ]
引数
[ @job_id = ] 'job_id'
指定したターゲット サーバーまたはターゲット サーバー グループに適用するジョブの、ジョブ識別番号を指定します。 @job_id は uniqueidentifier で、既定値は NULL です。
@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。
[ @job_name = ] N'job_name'
指定したターゲット サーバーまたはターゲット サーバー グループに適用するジョブの名前を指定します。 @job_name は sysname で、既定値は NULL です。
@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。
[ @target_server_groups = ] N'target_server_groups'
指定したジョブを適用するターゲット サーバー グループのコンマ区切りのリスト。 @target_server_groups は nvarchar(2048) で、既定値は NULL です。
[ @target_servers = ] N'target_servers'
指定したジョブの適用先となるターゲット サーバーのコンマ区切りのリスト。 @target_servers は nvarchar(2048) で、既定値は NULL です。
[ @operation = ] 'operation'
指定したジョブを、指定したターゲット サーバーまたはターゲット サーバー グループに適用するか、またはターゲット サーバー グループから削除するかを指定します。 @operation は varchar(7) で、既定値は APPLY です。 有効な操作は、 APPLY と REMOVEです。
リターン コードの値
0 (成功) または 1 (失敗)。
解説
sp_apply_job_to_targets は、複数のターゲット サーバーからジョブを適用 (または削除) する簡単な方法を提供します。これは、必要なターゲット サーバーごとに 1 回 sp_add_jobserver (または sp_delete_jobserver) を呼び出す代わりに使用できます。
アクセス許可
この手順では EXECUTE アクセス許可を付与できますが、これらのアクセス許可は SQL Server のアップグレード中にオーバーライドされる可能性があります。
例
次の例では、以前に作成した Backup Customer Information ジョブを、 Servers Maintaining Customer Information グループ内のすべてのターゲット サーバーに適用します。
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