Partager via

  • Article

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.

Icône Lien de rubriqueConventions 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 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.

    Notes

    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.

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