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.
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.
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.
Valores de código de retorno
0 (correcto) o 1 (error)
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)
sp_remove_job_from_targets (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)