Jobs Collection
The Jobs collection contains Job objects that reference all SQL Server Agent jobs defined on an instance of Microsoft® SQL Server™.
Properties
| Count Property |
Methods
| Add Method | Refresh Method |
| Item Method | Remove Method (Collections) |
| ItemByID Method | Script Method |
Remarks
With the Jobs collection, you can:
- Create a SQL Server Agent job.
- Remove a SQL Server Agent job.
- Generate Transact-SQL scripts used as part of job administration strategy for an instance of SQL Server.
For more information about creating a SQL Server Agent job, see Job Object.
To remove a SQL Server Agent job
- Use the Remove method of the Jobs collection, as in:
oJobServer.Jobs.Remove("Northwind_Backup_Diff")
When using the Item or Remove method, the Jobs collection supports member identification using either name or ordinal reference syntax. For example:
Set oJob = oJobServer.Jobs("Northwind_Backup_Log")
Or
Set oJob = oJobServer.Jobs(22)
Note Creating or removing SQL Server Agent jobs by using the Jobs collection requires appropriate privilege. The SQL Server login used for SQLServer object connection must be a member of the fixed role public in the system database msdb. With public membership, the connection may create jobs and schedule, execute, and remove jobs belonging to the connected login. Members of the db_owner role in msdb, or members of a role with greater privilege, can modify or delete any SQL Server Agent job.