AgentProfile.AssignToAgent(String, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Atribui o perfil de agente de replicação a um trabalho de agente de replicação específico.
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)
Parâmetros
- distributionDBName
- String
O nome do banco de dados de distribuição usado pelo trabalho do agente de replicação.
- agentId
- Int32
O trabalho do agente de replicação.
Exceções
Quando o perfil representado pelo objeto não existe no servidor.
Quando o valor de distributionDBName
é null
, contém caracteres null
ou tem mais de 128 caracteres Unicode.
Comentários
Um perfil de agente de replicação pode ser atribuído a um trabalho de agente de replicação somente depois de ter sido criado no banco de dados e ele só pode ser atribuído a um trabalho de agente para o tipo correto de agente de replicação.
Chamar AssignToAgent carrega as propriedades do perfil do servidor. Chame CommitPropertyChanges para confirmar alterações de propriedade antes de chamar esse método.
O AssignToAgent método só pode ser chamado por membros da sysadmin
função de servidor fixa no Distribuidor.
Chamar AssignToAgent é equivalente à execução de sp_update_agent_profile (Transact-SQL).