JobServer.ReassignJobsByLogin Method

Changes ownership for any SQL Server Agent job currently owned by a SQL Server login.

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

Syntax

'Declaration
Public Sub ReassignJobsByLogin ( _
    oldLogin As String, _
    newLogin As String _
)
'Usage
Dim instance As JobServer 
Dim oldLogin As String 
Dim newLogin As String

instance.ReassignJobsByLogin(oldLogin, _
    newLogin)

public void ReassignJobsByLogin(
    string oldLogin,
    string newLogin
)

public:
void ReassignJobsByLogin(
    String^ oldLogin, 
    String^ newLogin
)

member ReassignJobsByLogin : 
        oldLogin:string * 
        newLogin:string -> unit

public function ReassignJobsByLogin(
    oldLogin : String, 
    newLogin : String
)

Parameters

• oldLogin
  Type: System.String
  A String value that specifies the old SQL Server login.

• newLogin
  Type: System.String
  A String value that specifies the new SQL Server login.

Remarks

By default, any SQL Server login has membership, through the user guest, in the public role of the system database maintaining SQL Server Agent jobs (msdb). When a SQL Server user is created in msdb, jobs created by the user mapping the login are owned by the login, not the user.

Reassigning SQL Server Agent job ownership by using the ReassignJobsByLogin method requires appropriate permission. The SQL Server login used for the current connection must be a member of the fixed role sysadmin.

Examples

Scheduling Automatic Administrative Tasks in SQL Server Agent

See Also

Reference

JobServer Class

Microsoft.SqlServer.Management.Smo.Agent Namespace

Other Resources

Automated Administration Tasks (SQL Server Agent)

sp_delete_job (Transact-SQL)