AgentProfile.AssignToAgent(String, Int32) メソッド

定義

特定のレプリケーション エージェント ジョブにレプリケーション エージェント プロファイルを割り当てます。

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)

パラメーター

distributionDBName
String

レプリケーション エージェント ジョブによって使用されるディストリビューション データベースの名前。

agentId
Int32

レプリケーション エージェント ジョブ。

例外

オブジェクトによって表されるプロファイルがサーバーに存在しない場合に発生します。

distributionDBNamenull であるか、null 文字を含むか、128 Unicode 文字より長い場合に発生します。

注釈

レプリケーション エージェント プロファイルを割り当てるには、対象のレプリケーション エージェント ジョブがデータベース上に作成されている必要があります。また、正しい種類のレプリケーション エージェントのエージェント ジョブに対してのみ、割り当てることができます。

AssignToAgent を呼び出すと、サーバーからプロファイル プロパティが読み込まれます。 このメソッドを呼び出す前にプロパティの変更をコミットするには、CommitPropertyChanges を呼び出します。

メソッドは AssignToAgent 、ディストリビューターの固定サーバー ロールの sysadmin メンバーのみが呼び出すことができます。

呼び出し AssignToAgent は、 sp_update_agent_profileの実行 (Transact-SQL) と同じです。

適用対象

こちらもご覧ください