• Article

Job.EnumHistory Method (JobHistoryFilter)

Enumerates a list of execution history associated with the referenced job.

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

Syntax

'Declaration
Public Function EnumHistory ( _
    filter As JobHistoryFilter _
) As DataTable
'Usage
Dim instance As Job
Dim filter As JobHistoryFilter
Dim returnValue As DataTable

returnValue = instance.EnumHistory(filter)

public DataTable EnumHistory(
    JobHistoryFilter filter
)

public:
DataTable^ EnumHistory(
    JobHistoryFilter^ filter
)

member EnumHistory : 
        filter:JobHistoryFilter -> DataTable 

public function EnumHistory(
    filter : JobHistoryFilter
) : DataTable

Parameters

Return Value

Type: System.Data.DataTable
A DataTable object value that contains execution history data for the referenced job.

Examples

The following code example creates a job then displays its filtered execution history.

C#

Server srv = new Server("(local)");
Job jb = srv.JobServer.Jobs["Test Job"];
JobHistoryFilter jhf = new JobHistoryFilter();
jhf.JobID = jb.JobID
DataTable jobHistory = jb.EnumHistory(jhf);

PowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$jb = $srv.JobServer.Jobs["Test Job"]
$jhf = new-object Microsoft.SqlServer.Management.Smo.Agent.JobHistoryFilter
$jhf.JobID = $jb.JobID
$jobHistory = $jb.EnumHistory($jhf)