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.
Attribue le profil d’agent de réplication à un travail spécifique d’agent de réplication.
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
Le nom de la base de données de distribution utilisée par le job agent de réplication.
- agentId
- Int32
Le 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 null des caractères, ou est plus longue que 128 caractères Unicode.
Remarques
Un profil d’agent de réplication ne peut être attribué à une tâche d’agent de réplication qu’après sa création sur la base de données, et il ne peut être attribué qu’à une tâche d’agent pour le type correct d’agent de réplication.
L’appel AssignToAgent charge les propriétés du profil depuis le serveur. Appeler CommitPropertyChanges pour valider les modifications de propriété avant d’appeler cette méthode.
La AssignToAgent méthode ne peut être appelée que par les membres du sysadmin rôle serveur fixe au Distributeur.
Appeler AssignToAgent est équivalent à exécuter sp_update_agent_profile (Transact-SQL).