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) 。