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.
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 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)
Comentarios
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
Solo pueden ejecutar este procedimiento los miembros del rol fijo 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
Vea también
Referencia
sp_add_jobserver (Transact-SQL)
sp_delete_jobserver (Transact-SQL)