TargetServerGroup Object

SQL-DMO

SQL-DMO

TargetServerGroup Object

The TargetServerGroup object exposes the attributes of a multiserver administration target identification shortcut.

Properties
GroupID Property Name Property
Methods
AddMemberServer Method ListMemberServers Method
BeginAlter Method Refresh Method
CancelAlter Method Remove Method (Objects)
DoAlter Method RemoveMemberServer Method

Remarks

With Microsoft® SQL Server™ version 7.0, SQL Server Agent provides multiserver administration. The SQL Server Agent of an instance of SQL Server can direct job execution 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-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.