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 einem bestimmten Replikations-Agentauftrag das Replikations-Agentprofil zu.
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)
Parameter
- distributionDBName
- String
Der Name der Verteilungsdatenbank, die vom Replikations-Agent-Auftrag verwendet wird.
- agentId
- Int32
Der Replikations-Agent-Auftrag.
Ausnahmen
Wenn das durch das -Objekt dargestellte Profil auf dem Server nicht vorhanden ist.
Wenn der Wert für distributionDBName
ist null
, enthält null
Zeichen oder ist länger als 128 Unicode-Zeichen.
Hinweise
Ein Replikations-Agent-Profil kann nur einem Replikations-Agent-Auftrag zugewiesen werden, nachdem es in der Datenbank erstellt wurde, und es kann nur einem Agentauftrag für den richtigen Replikations-Agent-Typ zugewiesen werden.
Beim Aufrufen AssignToAgent werden Profileigenschaften vom Server geladen. Rufen Sie CommitPropertyChanges die Commiteigenschaftenänderungen auf, bevor Sie diese Methode aufrufen.
Die AssignToAgent -Methode kann nur von Mitgliedern der sysadmin
festen Serverrolle am Verteiler aufgerufen werden.
Das Aufrufen AssignToAgent entspricht der Ausführung sp_update_agent_profile (Transact-SQL).