Jaa


TargetServerGroup 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 TargetServerGroup object exposes the attributes of a multiserver administration target identification shortcut.

SQL-DMO object model that shows the current object

Properties

GroupID Property

Name Property

Methods

AddMemberServer Method

ListMemberServers Method

BeginAlter Method

Refresh Method

CancelAlter Method

Remove Method (Objects)

DoAlter Method

RemoveMemberServer Method

Remarks

The SQL Server Agent provides multi-server administration. SQL Server Agent can direct job execution from its own instance of SQL Server to another target server. 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.

The master SQL Server Agent allows group definition for its target servers. When target servers are grouped, jobs created on the master server can identify the group as an execution target. The job is executed on each target server in the group.

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

With the TargetServerGroup object, you can:

  • Create a SQL Server Agent target server group on a master SQL Server Agent server.
  • Add or remove target servers from a SQL Server Agent target server group.
  • Remove a target server group from a master SQL Server Agent server.

The Name property of the TargetServerGroup object can contain a maximum of 100 characters.