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 -> unit
Public 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) と同じです。