Job.Start Method (String)

Runs the referenced job starting at the specified job step.

Namespace:  Microsoft.SqlServer.Management.Smo.Agent
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Syntax

'Declaration
Public Sub Start ( _
    jobStepName As String _
)
'Usage
Dim instance As Job 
Dim jobStepName As String

instance.Start(jobStepName)
public void Start(
    string jobStepName
)
public:
void Start(
    String^ jobStepName
)
member Start : 
        jobStepName:string -> unit
public function Start(
    jobStepName : String
)

Parameters

  • jobStepName
    Type: System.String
    A String value that specifies the job step to start execution.

Examples

The following code example creates a job and starts it at the specified job step.

C#

Server srv = new Server("(local)");
Job jb = new Job(srv.JobServer, "Test Job");
jb.Create();
JobStep jbstp = new JobStep(jb, "Test Job Step");
jbstp.OnSuccessAction = StepCompletionAction.QuitWithSuccess;
jbstp.OnFailAction = StepCompletionAction.QuitWithFailure;
jbstp.Create();
jb.ApplyToTargetServer(srv.Name);
jb.IsEnabled = true;
jb.Start("Test Job Step");

PowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$jb = new-object Microsoft.SqlServer.Management.Smo.Agent.Job($srv.JobServer, "Testrrt Job")
$jb.Create()
$jbstp = new-object Microsoft.SqlServer.Management.Smo.Agent.JobStep($jb, "Test Job Step")
$jbstp.OnSuccessAction = [Microsoft.SqlServer.Management.Smo.Agent.StepCompletionAction]::QuitWithSuccess
$jbstp.OnFailAction = [Microsoft.SqlServer.Management.Smo.Agent.StepCompletionAction]::QuitWithFailure
$jbstp.Create()
$jb.ApplyToTargetServer($srv.Name)
$jb.IsEnabled = $TRUE
$jb.Start("Test Job Step")

See Also

Reference

Job Class

Start Overload

Microsoft.SqlServer.Management.Smo.Agent Namespace

Other Resources

Scheduling Automatic Administrative Tasks in SQL Server Agent

Automated Administration Tasks (SQL Server Agent)

sp_add_job (Transact-SQL)