Job.RemoveFromTargetServer(String) Job.RemoveFromTargetServer(String) Job.RemoveFromTargetServer(String) Method

정의

작업에 대해 관리되는 대상 서버의 목록에서 실행 대상 서버를 제거합니다. Removes an execution target server from the list of target servers maintained for a job.

public:
 void RemoveFromTargetServer(System::String ^ serverName);
public void RemoveFromTargetServer (string serverName);
Public Sub RemoveFromTargetServer (serverName As String)
매개 변수
serverName
String String String

A String 실행 대상 서버의 이름을 지정 하는 값입니다. A String value that specifies the name of the execution target server.

예제

다음 코드 예제에서는 "테스트 작업" 작업을 사용 하지 않도록 설정 하 고 여기에서 정의 된 모든 단계를 삭제 합니다.The following code example disables the "Test Job" job and deletes all defined steps from it.

C#C#

Server srv = new Server("(local)");  
Job jb = new Job(srv.JobServer, "Test Job");  
jb.ApplyToTargetServer(srv.Name);  
jb.RemoveFromTargetServer(srv.Name);  

PowerShellPowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")  
$jb = new-object Microsoft.SqlServer.Management.Smo.Agent.Job($srv.JobServer, "Test Job")  
$jb.RemoveFromTargetServer($srv.Name)  

설명

작성 하 고, 일정 한 작업을 실행할 때 사용 하 여는 ApplyToTargetServer 또는 ApplyToTargetServerGroup 실행 대상 서버를 추가 하는 메서드.When you create, schedule, and run jobs, use either the ApplyToTargetServer or the ApplyToTargetServerGroup method to add an execution target server. 단일 실행 대상을 사용 하 여 추가한는 ApplyToTargetServer 메서드는 RemoveFromTargetServer 메서드 제거 데 사용할 수 있습니다.When a single execution target has been added by using the ApplyToTargetServer method, the RemoveFromTargetServer method can be used to remove it.

작업을 실행 하는 로컬 서버에서 실행 되도록 ´ â 때 Microsoft SQL Server 에이전트 문자열을 사용 하 여 서버 이름을 지정 (local) 실행 대상을 제거 하는 경우.When a job is targeted to run on the local server running Microsoft SQL Server Agent, specify the server name using the string (local) when removing the execution target.

실행 대상 다중 서버 작업에서 제거 되 면 마스터 서버에서 대상 서버에 명령을 게시 합니다.When an execution target is removed from a multiserver job, the master server posts an instruction to the target server. 이 대상 서버는 작업의 자체 로컬 복사본을 삭제 하도록 나타냅니다.This indicates 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. 작업에서 모든 서버를 완전히 제거 하려면 사용 하 여는 Job 개체의 RemoveAllJobSteps 메서드 또는 JobServer 개체의 RemoveJobByID합니다.To completely remove a job from all participating servers, use the Job object's RemoveAllJobSteps method or the JobServer object's RemoveJobByID.

적용 대상