Edit

Modify a SQL Server Agent Proxy

  • Article

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 modify a Microsoft SQL Server Agent proxy in SQL Server by using SQL Server Management Studio or Transact-SQL.

Before You Begin

Limitations and Restrictions

  • SQL Server Agent proxies use credentials to store information about Windows user accounts. The user specified in the credential must have "Log on as a batch job" permission on the computer on which SQL Server is running.

  • SQL Server Agent checks subsystem access for a proxy and gives access to the proxy each time the job step runs. If the proxy no longer has access to the subsystem, the job step fails. Otherwise, SQL Server Agent impersonates the user that is specified in the proxy and runs the job step.

  • If the login for the user has access to the proxy, or the user belongs to any role with access to the proxy, the user can use the proxy in a job step.

Security

Permissions

Only members of the sysadmin fixed server role can create, modify, or delete proxy accounts.

Using SQL Server Management Studio

To modify a SQL Server Agent proxy

  1. In Object Explorer, click the plus sign to expand the server that contains the SQL Server Agent proxy account that you want to modify.

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

  3. Click the plus sign to expand the Proxies folder.

  4. Click the plus sign to expand the subsystem node for the proxy (for example, ActiveX Script).

  5. Right-click the proxy account you want to modify and select Properties.

  6. In the proxy_nameProxy Account Properties dialog box, make changes to the proxy account as necessary. For more information on the options in this dialog box, see Create a SQL Server Agent Proxy.

  7. When finished, click OK.

Using Transact-SQL

To modify a SQL Server Agent proxy

  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.

    -- Disables the proxy named 'Catalog application proxy'.  
USE msdb ;  
GO  
EXEC dbo.sp_update_proxy  
    @proxy_name = 'Catalog application proxy',  
    @enabled = 0;  
GO

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