Share via


AgentProfile.AssignToAgent(String, Int32) Méthode

Définition

Affecte le profil d'agent de réplication à un travail de l'agent de réplication spécifique.

public:
 void AssignToAgent(System::String ^ distributionDBName, int agentId);
public void AssignToAgent (string distributionDBName, int agentId);
member this.AssignToAgent : string * int -> unit
Public Sub AssignToAgent (distributionDBName As String, agentId As Integer)

Paramètres

distributionDBName
String

Nom de la base de données de distribution utilisée par le travail de l’agent de réplication.

agentId
Int32

Travail de l’agent de réplication.

Exceptions

Lorsque le profil représenté par l’objet n’existe pas sur le serveur.

Lorsque la valeur de distributionDBName est null, contient des null caractères ou est supérieure à 128 caractères Unicode.

Remarques

Un profil d’agent de réplication ne peut être affecté à un travail d’agent de réplication qu’une fois qu’il a été créé sur la base de données, et il peut être affecté uniquement à un travail d’agent pour le type correct d’agent de réplication.

L’appel AssignToAgent charge les propriétés de profil à partir du serveur. Appeler CommitPropertyChanges pour valider les modifications de propriété avant d’appeler cette méthode.

La AssignToAgent méthode peut être appelée uniquement par les membres du sysadmin rôle serveur fixe sur le serveur de distribution.

L’appel AssignToAgent équivaut à exécuter sp_update_agent_profile (Transact-SQL).

S’applique à

Voir aussi