Job.RemoveFromTargetServer Method

Article
12/15/2008

Removes an execution target server from the list of target servers maintained for a job.

Espace de noms: Microsoft.SqlServer.Management.Smo.Agent
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntaxe

'Déclaration
Public Sub RemoveFromTargetServer ( _
    serverName As String _
)

public void RemoveFromTargetServer (
    string serverName
)

public:
void RemoveFromTargetServer (
    String^ serverName
)

public void RemoveFromTargetServer (
    String serverName
)

public function RemoveFromTargetServer (
    serverName : String
)

Paramètres

serverName
A String value that specifies the name of the execution target server.

Notes

When you create, schedule, and run jobs, use either the ApplyToTargetServer or the ApplyToTargetServerGroup method to add an execution target server. When a single execution target has been added by using the ApplyToTargetServer method, the RemoveFromTargetServer method can be used to remove it.

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. To completely remove a job from all participating servers, use the Job object's RemoveAllJobSteps method or the JobServer object's RemoveJobByID.

Cet espace de noms, cette classe ou ce membre est pris en charge uniquement par la version 2.0 de Microsoft .NET Framework.

Exemple

How to: Create a Job with Steps and a Schedule in Visual Basic .NET

Sécurité des threads

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Plateformes

Plateformes de développement

Pour obtenir la liste des plateformes prises en charge, consultez Configuration matérielle et logicielle requise pour l'installation de SQL Server 2005.

Plateformes cibles

Pour obtenir la liste des plateformes prises en charge, consultez Configuration matérielle et logicielle requise pour l'installation de SQL Server 2005.

Voir aussi

Référence

Job Class
Job Members
Microsoft.SqlServer.Management.Smo.Agent Namespace

Autres ressources

Scheduling Automatic Administrative Tasks in SQL Server Agent
Automatisation des tâches administratives (SQL Server Agent)
sp_delete_targetsvrgrp_member (Transact-SQL)

Partager via