AgentProfile.AssignToAgent(String, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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).