Compartir vía


sp_update_proxy (Transact-SQL)

Se aplica a: SQL Server

Cambia las propiedades de un proxy existente.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_update_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @credential_name = ] N'credential_name' ]
    [ , [ @credential_id = ] credential_id ]
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @description = ] N'description' ]
[ ; ]

Argumentos

[ @proxy_id = ] proxy_id

Número de identificación del proxy que se va a cambiar. @proxy_id es int, con un valor predeterminado de NULL.

[ @proxy_name = ] N'proxy_name'

Nombre del proxy que se va a cambiar. @proxy_name es sysname, con un valor predeterminado de NULL.

[ @credential_name = ] N'credential_name'

Nombre de la nueva credencial para el proxy. @credential_name es sysname, con un valor predeterminado de NULL. Se deben especificar @credential_name o @credential_id .

[ @credential_id = ] credential_id

Número de identificación de la nueva credencial para el proxy. @credential_id es int, con un valor predeterminado de NULL. Se deben especificar @credential_name o @credential_id .

[ @new_name = ] N'new_name'

Nuevo nombre del proxy. @new_name es sysname, con un valor predeterminado de NULL. Cuando se proporciona, el procedimiento cambia el nombre del proxy a @new_name. Cuando este argumento es NULL, el nombre del proxy permanece sin cambios.

[ @enabled = ] enabled

Especifica si el proxy está habilitado. @enabled es tinyint, con un valor predeterminado de NULL. Cuando @enabled es 0, el proxy no está habilitado y no se puede usar en un paso de trabajo. Cuando este argumento es NULL, el estado del proxy permanece sin cambios.

[ @description = ] N'description'

Nueva descripción del proxy. @description es nvarchar(512), con un valor predeterminado de NULL. Cuando este argumento es NULL, la descripción del proxy permanece sin cambios.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

Se deben especificar @proxy_name o @proxy_id . Si se especifican los dos argumentos, deben hacer referencia al mismo proxy; de lo contrario, el procedimiento almacenado genera un error.

Se deben especificar @credential_name o @credential_id para cambiar la credencial del proxy. Si se especifican los dos argumentos, deben hacer referencia a la misma credencial; de lo contrario, el procedimiento almacenado genera un error.

Este procedimiento cambia el proxy, pero no cambia el acceso al proxy. Para cambiar el acceso a un proxy, use sp_grant_login_to_proxy y sp_revoke_login_from_proxy.

Permisos

Solo los miembros del rol fijo de seguridad sysadmin pueden ejecutar este procedimiento.

Ejemplos

En el siguiente ejemplo se establece el valor habilitado para el Catalog application proxy en 0.

USE msdb;
GO

EXEC dbo.sp_update_proxy
    @proxy_name = 'Catalog application proxy',
    @enabled = 0;
GO