sp_apply_job_to_targets (Transact-SQL)

Статья
06/18/2013

Применяет задание к одному или нескольким целевым серверам или к целевым серверам, принадлежащим к одной или нескольким группам целевых серверов.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

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

Аргументы

[ @job_id =] job_id
Идентификационный номер задания, которое следует применить к указанным целевым серверам и группам целевых серверов. Аргумент job_id имеет тип uniqueidentifier и значение по умолчанию NULL.
[ @job_name =] 'job_name'
Имя указания, которое следует применить к связанным целевым серверам и группам целевых серверов. Аргумент job_name имеет тип sysname и значение по умолчанию NULL.

Примечание

Необходимо указать либо job_id, либо job_name, но не оба аргумента одновременно.
[ @target_server_groups =] 'target_server_groups'
Список групп целевых серверов с разделителями-запятыми, к которым следует применить указанное задание. Аргумент target_server_groups имеет тип nvarchar(2048) и значение по умолчанию NULL.
[ @target_servers= ] 'target_servers'
Список целевых серверов с разделителями-запятыми, к которым следует применить указанное задание. Аргумент target_servers имеет тип nvarchar(2048) и значение по умолчанию NULL.
[ @operation= ] 'operation'
Определяет, должно ли указанное задание быть применено или удалено с указанных целевых серверов или групп целевых серверов. Аргумент operationимеет тип varchar(7) и значение по умолчанию APPLY. Допустимыми операциями являются APPLY и REMOVE.

Примечание
Необходимо указать либо job_id, либо job_name, но не оба аргумента одновременно.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Процедура sp_apply_job_to_targets обеспечивает легкий способ применения (или удаления) задания к нескольким целевым серверам и является альтернативным методом одноразового вызова процедуры sp_add_jobserver (или sp_delete_jobserver) для каждого целевого сервера в случае необходимости.

Разрешения

Эту процедуру могут выполнять только члены предопределенной роли сервера sysadmin.

Примеры

В следующем примере ко всем целевым серверам в группе Servers Maintaining Customer Information применяется ранее созданное задание Backup 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