• Article

TargetServer Object

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The TargetServer object represents an instance of Microsoft SQL Server on which a SQL Server Agent job is to run.

SQL-DMO object model that shows the current object

Methods

Refresh Method

Remarks

A SQL Server Agent job has an execution target. The SQL Server Agent can direct job execution from one instance of SQL Server to another within the same organization. Servers can enlist in the domain specified by a master SQL Server Agent. When a server enlists in a domain, it becomes a target server for job execution managed by the master SQL Server Agent.

Any instance on which SQL Server Agent is running provides the local instance as a valid target for job execution.

Target servers are defined only on a master SQL Server Agent, and the SQL Distributed Management Objects (SQL-DMO) TargetServers collection and each TargetServer object are populated only when SQL-DMO applications connect to an instance of SQL Server identified as the master in a multi-server administration group.

With the TargetServer object, you can:

  • Report the properties of a server that is an existing target in a multi-server administration group.

  • Set the location string for a server that is an existing target in a multi-server administration group.