RemoveFromTargetServerGroup Method

この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。 新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。

The RemoveFromTargetServerGroup method drops one or more execution targets for a SQL Server Agent job.

構文

object.RemoveFromTargetServerGroup(Val)

Parts

• object
  Expression that evaluates to an object in the Applies To list.

• Val
  String that specifies a single target server group by name.

Prototype (C/C++)

HRESULT RemoveFromTargetServerGroup(
SQLDMO_LPCSTR NewVal);

説明

Before a SQL Server Agent job can execute, the job must have at least one step and an execution target. When SQL Server Agent acts as a master server for multiserver administration servers, known execution targets servers can be grouped for easier targeting of multiple servers at one time.

When using SQL-DMO to create, schedule, and run SQL Server Agent jobs, use either the ApplyToTargetServer or ApplyToTargetServerGroup method to add an execution target. When one or more target servers have been targeted by using the ApplyToTargetServerGroup method, use the RemoveFromTargetServerGroupmethod to remove the group execution target.

For more information about configuring target server groups by using SQL Distributed Management Objects (SQL-DMO), see TargetServerGroup Object.

注意

When a group execution target is removed for a multiserver administration job, the master server posts job-delete instructions to all TSXs named in the group. The job is removed from grouped target servers, but remains defined at the target server. To completely remove a job from all servers participating in multiserver administration, use a job removing method such as the Remove method of the Job object or the RemoveJobByID method of the JobServer object.

Applies To:

Job Object