AgentProfile.AssignToAgent(String, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Weist das Replikationsagentenprofil einem bestimmten Replikationsagentenjob zu.
public:
void AssignToAgent(System::String ^ distributionDBName, int agentId);public void AssignToAgent(string distributionDBName, int agentId);member this.AssignToAgent : string * int -> unitPublic Sub AssignToAgent (distributionDBName As String, agentId As Integer)Parameter
- distributionDBName
- String
Der Name der Verteilungsdatenbank, die vom Job des Replikationsagenten verwendet wird.
- agentId
- Int32
Der Job des Replikationsagenten.
Ausnahmen
Wenn das vom Objekt dargestellte Profil auf dem Server nicht existiert.
Wenn der Wert für distributionDBName ist null, enthält null sie Zeichen oder ist länger als 128 Unicode-Zeichen.
Hinweise
Ein Replikationsagentenprofil kann einem Replikationsagenten-Job erst zugewiesen werden, nachdem dieser in der Datenbank erstellt wurde, und es kann nur einem Agent-Job für den richtigen Typ eines Replikationsagenten zugewiesen werden.
Das Aufrufen AssignToAgent lädt Profileigenschaften vom Server. Ruf auf, CommitPropertyChanges um Eigenschaftsänderungen zu committen, bevor du diese Methode aufrufst.
Die Methode AssignToAgent kann nur von Mitgliedern der sysadmin festen Serverrolle beim Verteiler aufgerufen werden.
Das Aufrufen AssignToAgent entspricht der Ausführung sp_update_agent_profile (Transact-SQL).