sp_apply_job_to_targets (Transact-SQL)

Applique un travail à un ou plusieurs serveurs cibles ou aux serveurs cibles d'un ou de plusieurs groupes de serveurs cibles.

Syntaxe

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

Arguments

• [ @job_id =] job_id
  Numéro d'identification du travail à appliquer aux serveurs ou groupes de serveurs cibles spécifiés. job_id est de type uniqueidentifier, avec une valeur par défaut NULL.

• [ @job_name =] 'job_name'
  Nom du travail à appliquer aux serveurs ou groupes de serveurs cibles spécifiés. L'argument job_name est de type sysname, avec une valeur par défaut NULL.

  Remarque :
  Vous devez définir la valeur de job_id ou de job_name, mais pas les deux valeurs à la fois.

• [ @target_server_groups =] 'target_server_groups'
  Liste référençant, entre virgules, les groupes de serveurs cibles auxquels le travail spécifié est appliqué. L'argument target_server_groups est de type nvarchar(2048), avec une valeur par défaut NULL.

• [ @target_servers= ] 'target_servers'
  Liste référençant, entre virgules, les groupes de serveurs cibles auxquels le travail spécifié est appliqué. L'argument target_serversest de type nvarchar(2048), avec une valeur par défaut NULL.

• [ @operation= ] 'operation'
  Indique si le travail spécifié doit être appliqué ou supprimé des serveurs ou groupes de serveurs cibles indiqués. operationest de type varchar(7) et sa valeur par défaut est APPLY. Les opérations valides sont APPLY et REMOVE.

Notes

sp_apply_job_to_targets constitue un moyen facile d'affecter (ou de supprimer) un travail à plusieurs serveurs cibles ; elle évite d'avoir à appeler sp_add_jobserver (ou sp_delete_jobserver) pour chaque serveur cible requis.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Exemples

L'exemple suivant applique le travail Backup Customer Information créé précédemment à tous les serveurs cibles du groupe 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

Voir aussi

Référence

sp_add_jobserver (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
sp_remove_job_from_targets (Transact-SQL)
Procédures stockées système (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005