• Article

Microsoft.SqlServer.Management.Smo.Agent Namespace

The Microsoft.SqlServer.Management.Smo.Agent namespace contains classes that represent the SQL Server Agent.

The Microsoft.SqlServer.Management.Smo.Agent namespace represents the SQL Server Agent. After a connection to an instance of SQL Server has been established by using the Server object variable, you can use the objects in the Microsoft.SqlServer.Management.Smo.Agent namespace to manage the SQL Server Agent.

The Microsoft.SqlServer.Management.Smo.Agent namespace resides in the Microsoft.SqlServer.Smo.dll assembly file. Also, some of the enumeration classes are in the Microsoft.SqlServer.SqlEnum.dll and Microsoft.SqlServer.SmoEnum.dll assembly files. You will have to import all three files to access the classes in the Microsoft.SqlServer.Management.Smo.Agent namespace.

By using the Microsoft.SqlServer.Management.Smo.Agent namespace, you can do the following:

  • View and modify SQL Server Agent settings.

  • Set up and manage operators.

  • Set up and manage alerts based on system messages or performance conditions.

  • Set up and manage jobs with multiple steps and schedules.

  • Manage proxy accounts for the subsystems on which jobs run.

  • Manage jobs that run on multiple servers.

Classes

  Class Description
Public class AgentObjectBase The AgentObjectBase class is a base class that is inherited by all the SQL Server Agent classes and contains common members.
Public class Alert The Alert class represents a Microsoft SQL Server Agent alert.
Public class AlertCategory The AlertCategory class contains attributes that allow alerts to be categorized.
Public class AlertCategoryCollection The AlertCategoryCollection class represents a collection of AlertCategory objects that represent all the categories defined on the parent object.
Public class AlertCollection The AlertCollection class represents a collection of Alert objects that represent all the alerts defined on the parent object.
Public class AlertSystem The AlertSystem class contains system information pertaining to all alerts defined on the instance of Microsoft SQL Server.
Public class CategoryBase The CategoryBase class is a base class that is used in the construction of the JobCategory class, the OperatorCategory class, and the AlertCategory class. It contains functionality that is common to all three category classes.
Public class Job The Job class represents a Microsoft SQL Server Agent job.
Public class JobCategory The JobCategory class contains attributes that allow alerts to be categorized.
Public class JobCategoryCollection The JobCategoryCollection class represents a collection of JobCategory objects that represent all the categories defined on the parent object.
Public class JobCollection The JobCollection class represents a collection of Job objects that represent all the jobs defined on the JobServer object.
Public class JobFilter The JobFilter object is used to store information about the constraints applied to the EnumJobs method of the JobServer object.
Public class JobHistoryFilter The JobHistoryFilter object is used to store information about the constraints applied to the EnumJobHistory method of the JobServer object.
Public class JobSchedule The JobSchedule class represents a SQL Server Agent job schedule.
Public class JobScheduleCollection The JobScheduleCollection class represents a collection of JobSchedule objects that represent all the job schedules defined on the parent object.
Public class JobServer The JobServer object represents the SQL Server Agent subsystem and the msdb database.
Public class JobStep The JobStep class represents a Microsoft SQL Server job step.
Public class JobStepCollection The JobStepCollection class represents a collection of JobStep objects that represent all the job steps defined on the parent Job object.
Public class Operator The Operator class represents a SQL Server Agent operator.
Public class OperatorCategory The OperatorCategory class contains attributes that allow operators to be categorized.
Public class OperatorCategoryCollection The OperatorCategoryCollection class represents a collection of OperatorCategory objects that represent all the categories defined on the parent object.
Public class OperatorCollection The OperatorCollection class represents a collection of Operator objects that represent all the operators defined on the JobServer object.
Public class ProxyAccount The ProxyAccount class represents a SQL Server Agent proxy account.
Public class ProxyAccountCollection The ProxyAccountCollection class represents a collection of ProxyAccount objects that represent all the proxy accounts defined on SQL Server Agent.
Public class ScheduleBase The ScheduleBase class is a base class that is inherited by the JobSchedule class.
Public class TargetServer The TargetServer object represents a target server defined for multiserver administration on SQL Server Agent.
Public class TargetServerCollection The TargetServerCollection class represents a collection of TargetServer objects that represent all the target servers defined on SQL Server Agent.
Public class TargetServerGroup The TargetServerGroup object that represent a target server group defined for multi-server administration on SQL Server Agent.
Public class TargetServerGroupCollection The TargetServerGroupCollection class represents a collection of TargetServerGroup objects that represent all the target server groups defined on SQL Server Agent.

Enumerations

  Enumeration Description
Public enumeration ActivationOrder The ActivationOrder enumeration contains values that are used to specify when the trigger runs in relation to the insert, update, or delete operation.
Public enumeration AgentLogLevels The AgentLogLevels enumeration contains values that are used to specify the type of errors or messages that are logged by SQL Server. This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.
Public enumeration AgentMailType The AgentMailType enumeration contains values that are used to specify the source of mail.
Public enumeration AgentSubSystem The AgentSubSystem enumeration contains values that are used to specify the Microsoft SQL Server subsystems that can be used by job steps.
Public enumeration AlertType The AlertType enumeration contains values that are used to specify the type of event or performance condition that causes alerts to be raised.
Public enumeration CategoryType The CategoryType enumeration is a list of constant values that specify the type of category, such as whether the category refers to local jobs or multiserver administration.
Public enumeration CompletionAction The CompletionAction enumeration is a list of constant values that specify the circumstances when a job completes after which another action is executed.
Public enumeration CompletionResult The CompletionResult enumeration is a list of constant values that specify the status on completion of a job or job step.
Public enumeration FindOperand The FindOperand enumeration represents a list of operands that are used to evaluate the DateJobCreated and DateJobLastModified properties to specify a range of dates in a job filter.
Public enumeration FrequencyRelativeIntervals The FrequencyRelativeIntervals enumeration contains values that are used to specify the ordinal position of a recurring occurrence within a specified period.
Public enumeration FrequencySubDayTypes The FrequencySubDayTypes enumeration contains values that are used to specify the way in which scheduling is managed within the period of a day.
Public enumeration FrequencyTypes The FrequencyTypes enumeration contains values that are used to specify how often a schedule is executed.
Public enumeration JobExecutionStatus The JobExecutionStatus enumeration is a list of constant values that specify the execution status of a job or job step.
Public enumeration JobOutcome The JobOutcome enumeration is a list of constant values that specify the outcome after running a job.
Public enumeration JobServerType The JobServerType enumeration is a list of constant values that specify the type of server with regard to multiserver or stand-alone administration.
Public enumeration JobStepFlags The JobStepFlags enumeration is a list of constant values that specify the file to which to append job history information.
Public enumeration JobType The JobType enumeration is a list of constant values that specify the location where the job is run (locally or on multiple servers).
Public enumeration MonthlyRelativeWeekDays The MonthlyRelativeWeekDays enumeration contains values that specify the days of the week, weekdays, or every day.
Public enumeration NotifyMethods The NotifyMethods enumeration contains values that specify the method used to notify operators in an alert or a job. This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.
Public enumeration NotifyType The NotifyType enumeration contains values that are used to specify the notification type that restricts the output of the Alert object's EnumNotifications method.
Public enumeration OSRunPriority The OSRunPriority enumeration contains constant values that specify the levels of priority given to running the operating system.
Public enumeration StepCompletionAction The StepCompletionAction enumeration contains values that specify the action taken on completion of a job step.
Public enumeration TargetServerStatus The TargetServerStatus enumeration contains values that specify the status of a target server. This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.
Public enumeration WeekDays The WeekDays enumeration contains constant values that specify the days of the week.