sp_remove_job_from_targets (Transact-SQL)

指定したジョブを指定した対象サーバーまたは対象サーバー グループから削除します。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

sp_remove_job_from_targets [ @job_id = ] job_id 
     | [ @job_name = ] 'job_name' 
     [ , [ @target_server_groups = ] 'target_server_groups' ] 
     [ , [ @target_servers = ] 'target_servers' ]

引数

  • [ @job_id =] job_id
    指定された対象サーバーまたは対象サーバー グループから削除されるジョブのジョブ識別番号を指定します。job_id または job_name のいずれかを指定する必要があります。両方を指定することはできません。job_id のデータ型は uniqueidentifier で、既定値は NULL です。

  • [ @job_name =] 'job_name'
    指定された対象サーバーまたは対象サーバー グループから削除されるジョブの名前を指定します。job_id または job_name のいずれかを指定する必要があります。両方を指定することはできません。job_name のデータ型は sysname で、既定値は NULL です。

  • [ @target_server_groups =] 'target_server_groups'
    指定したジョブの削除元である対象サーバー グループをコンマで区切って指定します。target_server_groups のデータ型は nvarchar(1024) で、既定値は NULL です。

  • [ @target_servers =] 'target_servers'
    指定したジョブの削除元である対象サーバーをコンマで区切って指定します。target_servers のデータ型は nvarchar(1024) で、既定値は NULL です。

戻り値

0 (成功) または 1 (失敗)

権限

このプロシージャの実行権限は、既定では sysadmin 固定サーバー ロールのメンバに与えられています。

次の例では、以前に作成された Weekly Sales Backups ジョブを対象サーバー グループ Servers Processing Customer Orders、およびサーバー SEATTLE1 とサーバー SEATTLE2 から削除します。

USE msdb ;
GO

EXEC dbo.sp_remove_job_from_targets
    @job_name = N'Weekly Sales Backups',
    @target_server_groups = N'Servers Processing Customer Orders', 
    @target_servers = N'SEATTLE2,SEATTLE1' ;
GO