Share via

Job.DeleteLevel Property

  • Article

Gets or sets the completion action that determines whether to delete the job definition when the job finishes execution.

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

Syntax

'Declaration
<SfcPropertyAttribute(SfcPropertyFlags.Standalone)> _
Public Property DeleteLevel As CompletionAction 
    Get 
    Set
'Usage
Dim instance As Job 
Dim value As CompletionAction 

value = instance.DeleteLevel

instance.DeleteLevel = value

[SfcPropertyAttribute(SfcPropertyFlags.Standalone)]
public CompletionAction DeleteLevel { get; set; }

[SfcPropertyAttribute(SfcPropertyFlags::Standalone)]
public:
property CompletionAction DeleteLevel {
    CompletionAction get ();
    void set (CompletionAction value);
}

[<SfcPropertyAttribute(SfcPropertyFlags.Standalone)>]
member DeleteLevel : CompletionAction with get, set

function get DeleteLevel () : CompletionAction 
function set DeleteLevel (value : CompletionAction)

Property Value

Type: Microsoft.SqlServer.Management.Smo.Agent.CompletionAction
A CompletionAction object value that specifies whether to delete the job definition.

Remarks

If directed, Microsoft SQL Server Agent can delete a job definition when execution succeeds or fails. Jobs can also be deleted regardless of success or failure of the job. By default, jobs are not deleted when execution finishes.

Examples

The following code example creates a new job and displays the date on which it was last modified.

C#

Server srv = new Server("(local)");
Job jb = new Job(srv.JobServer, "Test Job");
jb.DeleteLevel = CompletionAction.Always;

PowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$jb = new-object Microsoft.SqlServer.Management.Smo.Agent.Job($srv.JobServer, "Test Job")
$jb.DeleteLevel = [Micrososft.SqlServer.Management.Smo.Agent.CompletionAction]::Always

See Also

Reference

Job Class

Microsoft.SqlServer.Management.Smo.Agent Namespace

Other Resources

Automated Administration Tasks (SQL Server Agent)

sp_add_job (Transact-SQL)

Scheduling Automatic Administrative Tasks in SQL Server Agent