• Article

Job.DeleteLevel Property

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