sp_apply_job_to_targets (Transact-SQL)

Artigo
06/18/2013

Aplica um trabalho a um ou mais servidores de destino ou aos servidores de destino pertencentes a um ou mais grupos de servidores de destino.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @job_id =] job_id
O número de identificação do trabalho a ser aplicado aos servidores de destino ou grupos de servidores de destino especificados. job_id é uniqueidentifier, com um padrão NULL.
[ @job_name =] 'job_name'
O nome do trabalho a ser aplicado aos grupos de servidores de destino ou servidores de destino associados especificados. job_name é sysname, com um padrão NULL.

Observação

É necessário especificar a job_id ou o job_name, mas não é possível especificar ambos ao mesmo tempo.
[ @target_server_groups =] 'target_server_groups'
Uma lista separada por vírgulas de grupos de servidores de destino aos quais o trabalho especificado será aplicado. target_server_groups é nvarchar(2048), com um padrão NULL.
[ @target_servers= ] 'target_servers'
Uma lista separada por vírgulas de servidores de destino aos quais o trabalho especificado será aplicado. target_servers é nvarchar(2048), com um padrão NULL.
[ @operation= ] 'operation'
Se o trabalho especificado deve ser aplicado aos ou removidos dos servidores de destino ou grupos de servidores de destino especificados. operationé varchar(7), com um padrão APPLY. As operações válidas são APPLY e REMOVE.

Observação
É necessário especificar a job_id ou o job_name, mas não é possível especificar ambos ao mesmo tempo.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_apply_job_to_targets fornece uma maneira fácil de aplicar (ou remover) um trabalho em vários servidores de destino, sendo uma alternativa à chamada de sp_add_jobserver (ou sp_delete_jobserver) uma vez para cada servidor de destino necessário.

Permissões

Somente os membros da função de servidor fixa sysadmin podem executar este procedimento.

Exemplos

O exemplo a seguir aplica o trabalho Backup Customer Information criado anteriormente a todos os servidores de destino do grupo 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