다음을 통해 공유


RemoveFromTargetServer Method

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 응용 프로그램은 수정하십시오.

The RemoveFromTargetServer method drops a single execution target for a SQL Server Agent job.

구문

object
.RemoveFromTargetServer(
Val
)

Parts

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

  • Val
    String that specifies an instance of Microsoft SQL Server by name.

Prototype (C/C++)

HRESULT RemoveFromTargetServer(
SQLDMO_LPCSTR NewVal);

주의

Before a SQL Server Agent job can execute, the job must have at least one step and an execution target.

When using SQL Distributed Management Objects (SQL-DMO) to create, schedule, and run SQL Server Agent jobs, use either the ApplyToTargetServer or ApplyToTargetServerGroup method to add an execution target. When a single execution target has been added by using the ApplyToTargetServer method, use the RemoveFromTargetServer method to remove the execution target.

When a job is targeted to run on the server running SQL Server Agent, specify the server name using the string (local) when removing the execution target.

[!참고]

When an execution target is removed for a multiserver administration job, the master server posts an instruction to the target server indicating that the target server should drop its local copy of the job. The job is removed from the target server but remains defined at the master 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: