Artículo
09/29/2010

sp_apply_job_to_targets (Transact-SQL)

Aplica un trabajo a uno o más servidores de destino, o a los servidores de destino que pertenecen a uno o más grupos de servidores de destino.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

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
Número de identificación del trabajo que se va a aplicar a los servidores de destino o grupos de servidores de destino especificados. job_id es de tipo uniqueidentifier y su valor predeterminado es NULL.
[ @job_name =] 'job_name'
Nombre del trabajo que se va a aplicar a los servidores de destino o grupos de servidores de destino asociados especificados. job_name es de tipo sysname y su valor predeterminado es NULL.

[!NOTA]

Se debe especificar job_id o job_name, pero no ambos.
[ @target_server_groups =] 'target_server_groups'
Lista separada por comas que contiene los grupos de servidores de destino a los que se va a aplicar el trabajo especificado. target_server_groups es de tipo nvarchar(2048) y su valor predeterminado es NULL.
[ @target_servers= ] 'target_servers'
Lista separada por comas que contiene los servidores de destino a los que se va a aplicar el trabajo especificado. target_serverses de tipo nvarchar(2048) y su valor predeterminado es NULL.
[ @operation= ] 'operation'
Indica si se debe aplicar o quitar el trabajo especificado en los servidores de destino o grupos de servidores de destino especificados. operationes de tipo varchar(7) y su valor predeterminado es APPLY. Las operaciones válidas son APPLY y REMOVE.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

sp_apply_job_to_targets proporciona una forma sencilla de aplicar (o quitar) un trabajo en varios servidores de destino y es una alternativa a llamar a sp_add_jobserver (o sp_delete_jobserver) una vez para cada servidor de destino requerido.

Permisos

Sólo pueden ejecutar este procedimiento los miembros de la función fija de servidor sysadmin.

Ejemplos

En el ejemplo siguiente se aplica el trabajo Backup Customer Information, creado anteriormente, a todos los servidores de destino del 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