Compartir a través de


sp_update_proxy (Transact-SQL)

Cambia las propiedades de un proxy existente.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_update_proxy 
    [ @proxy_id = ] id,
    [ @proxy_name = ] 'proxy_name',
    [ @credential_name = ] 'credential_name' ,
    [ @credential_id = ] credential_id ,
    [ @new_name = ] 'new_name' ,
    [ @enabled = ] is_enabled ,
    [ @description = ] 'description'

Argumentos

  • [ @proxy_id= ] id
    Número de identificación del proxy que se va a cambiar. proxy_id es de tipo int y su valor predeterminado es NULL.

  • [ @proxy_name= ] 'proxy_name'
    Nombre del proxy que se va a cambiar. proxy_name es de tipo sysname y su valor predeterminado es NULL.

  • [ @credential_name = ] 'credential_name'
    Nombre de la nueva credencial para el proxy. credential_name es de tipo sysname y su valor predeterminado es NULL. Puede especificarse credential_name o credential_id.

  • [ @credential_id = ] credential_id
    Número de identificación de la nueva credencial para el proxy. credential_id es de tipo int y su valor predeterminado es NULL. Puede especificarse credential_name o credential_id.

  • [ @new_name= ] 'new_name'
    Nuevo nombre del proxy. new_name es de tipo sysname y su valor predeterminado es NULL. Si se proporciona, el procedimiento cambia el nombre del proxy a new_name. Si este argumento es NULL, el nombre del proxy no varía.

  • [ @enabled = ] is_enabled
    Especifica si el proxy está habilitado. La marca is_enabled es de tipo tinyint y su valor predeterminado es NULL. Si is_enabled es 0, el proxy no está habilitado y no puede ser utilizado por un paso de trabajo. Si este argumento es NULL, el estado del proxy no varía.

  • [ @description= ] 'description'
    Nueva descripción del proxy. description es de tipo nvarchar(512) y su valor predeterminado es NULL. Si este argumento es NULL, la descripción del proxy no varía.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Se debe 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 debe especificar @credential_name o @credential_id para cambiar la credencial para el 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 al proxy, utilice sp_grant_login_to_proxy y sp_revoke_login_from_proxy.

Permisos

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

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

Vea también

Referencia

Procedimientos almacenados del Agente SQL Server (Transact-SQL)

sp_add_proxy (Transact-SQL)

sp_delete_proxy (Transact-SQL)

sp_grant_login_to_proxy (Transact-SQL)

sp_revoke_login_from_proxy (Transact-SQL)

Conceptos

Implementar la seguridad del Agente SQL Server