Export (0) Print
Expand All

Job.Alter Method

Updates any Job object property changes on an instance of Microsoft SQL Server. 

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

public void Alter()

Implements

IAlterable.Alter()

The Alter method updates any changes that have been made to the properties of the Job object since the Job object was created, or since the last Alter statement. The modifications are combined and sent to the instance of SQL Server in a single network trip to the instance of SQL Server.

Users must have Execute permissions on the msdb.dbo.sp_help_operator stored procedure to script or alter properties on a SQL Server 2000 job.

When connected to an instance of SQL Server 2000, users other than sa do not automatically have permissions to run the Alter method. The system administrator must grant Execute permissions on the msdb.dbo.sp_help_operator stored procedure to any user who has to script or alter a SQL Server 2000 job.

The following code example creates a job, changes a job property, and calls Alter to update the instance.

C#

Server srv = new Server("(local)");
Job jb = new Job(srv.JobServer, "Test Job");
jb.Create();
jb.OperatorToEmail = "OperatorName";
jb.Alter();

PowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$jb = new-object Microsoft.SqlServer.Management.Smo.Agent.Job($srv.JobServer, "Test Job")
$jb.Create()
$jb.OperatorToEmail = "OperatorName"
$jb.Alter()

Community Additions

ADD
Show:
© 2014 Microsoft