sp_delete_proxy (Transact-SQL)

Applies to: SQL Server

Removes the specified proxy.

Transact-SQL syntax conventions

Syntax

sp_delete_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
[ ; ]

Arguments

[ @proxy_id = ] proxy_id

The proxy identification number of the proxy to remove. @proxy_id is int, with a default of NULL.

[ @proxy_name = ] N'proxy_name'

The name of the proxy to remove. @proxy_name is sysname, with a default of NULL.

Return code values

0 (success) or 1 (failure).

Result set

None.

Remarks

Either @proxy_name or @proxy_id must be specified. If both arguments are specified, the arguments must both refer to the same proxy or the stored procedure fails.

If a job step refers to the proxy specified, the proxy can't be deleted and the stored procedure fails.

Permissions

By default, only members of the sysadmin fixed server role can execute sp_delete_proxy.

Examples

The following example deletes the proxy Catalog application proxy.

USE msdb;
GO

EXEC dbo.sp_delete_proxy
    @proxy_name = N'Catalog application proxy' ;
GO