sp_apply_job_to_targets (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)

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

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

Vea también

Referencia