AgentProfile.AssignToAgent(String, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
レプリケーションエージェントのプロファイルを特定のレプリケーションエージェントのジョブに割り当てます。
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)パラメーター
- distributionDBName
- String
レプリケーションエージェントジョブで使用される配布データベースの名前。
- agentId
- Int32
複製エージェントのジョブです。
例外
オブジェクトで表されるプロファイルがサーバー上に存在しない場合。
distributionDBNameの値がnull、null文字を含む、または128-Unicode文字より長い場合。
注釈
レプリケーションエージェントのプロファイルは、データベース上で作成された後にのみレプリケーションエージェントジョブに割り当てられ、正しいタイプのレプリケーションエージェントに対してのみエージェントジョブに割り当てられます。
AssignToAgentを呼び出すとサーバーからプロファイルプロパティが読み込まれます。 このメソッドを呼び出す前に、プロパティの変更をコミットするために CommitPropertyChanges を呼び出してください。
AssignToAgentメソッドはディストリビューターのsysadmin固定サーバーロールのメンバーのみが呼び出せます。
AssignToAgentを呼び出すことはsp_update_agent_profileを実行するのと同じです(Transact-SQL)。