Delete a Job Category

Applies to: SQL Server Azure SQL Managed Instance

Important

On Azure SQL Managed Instance, most, but not all SQL Server Agent features are currently supported. See Azure SQL Managed Instance T-SQL differences from SQL Server for details.

This topic describes how to delete a Microsoft SQL Server Agent job category in SQL Server by using SQL Server Management Studio, Transact-SQL or SQL Server Management Objects.

Job categories help you organize your jobs for easy filtering and grouping. For example, you can organize all your database backup jobs in the Database Maintenance category.

Before You Begin

Limitations and Restrictions

When you delete a user-defined job category, SQL Server Agent prompts you to reassign the jobs that are assigned to it to another job category. You can only delete user-defined job categories.

Security

For detailed information, see Implement SQL Server Agent Security.

Using SQL Server Management Studio

To delete a job category

  1. In Object Explorer, click the plus sign to expand the server where you want to delete a job category.

  2. Click the plus sign to expand SQL Server Agent.

  3. Right-click the Jobs folder and select Manage Job Categories.

  4. In the Manage Job Categoriesserver_name dialog box, select the job category to delete.

  5. Click Delete.

  6. In the Job Categories dialog box, click Yes.

  7. Close the Manage Job Categoriesserver_name dialog box.

Using Transact-SQL

To delete a job category

  1. In Object Explorer, connect to an instance of Database Engine.

  2. On the Standard bar, click New Query.

  3. Copy and paste the following example into the query window and click Execute.

    -- deletes the job category named AdminJobs.  
    USE msdb ;  
    GO   
    EXEC dbo.sp_delete_category  
        @name = N'AdminJobs',  
        @class = N'JOB' ;  
    GO  
    

For more information, see sp_delete_category (Transact-SQL).

Using SQL Server Management Objects

To delete a job category

Call the JobCategory class by using a programming language that you choose, such as Visual Basic, Visual C#, or PowerShell.