sp_apply_job_to_targets (Transact-SQL)

Article
08/19/2013

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

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

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 NULL comme valeur par défaut.
[ @job_name =] 'job_name'
Nom du travail à appliquer aux serveurs ou groupes de serveurs cibles associés spécifiés. job_name est de type sysname, avec NULL comme valeur par défaut.

[!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é. target_server_groups est de type nvarchar(2048), avec NULL comme valeur par défaut.
[ @target_servers= ] 'target_servers'
Liste référençant, entre virgules, les serveurs cibles auxquels le travail spécifié est appliqué. target_serversest de type nvarchar(2048), avec NULL comme valeur par défaut.
[ @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), avec APPLY comme valeur par défaut. Les opérations valides sont APPLY et REMOVE.

Valeurs des codes renvoyés

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

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.

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