Compartilhar via


sp_update_proxy (Transact-SQL)

Altera as propriedades de um proxy existente.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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
    O número de identificação de proxy do proxy a ser alterado. O proxy_id é int, com um padrão de NULL.

  • [ @proxy_name= ] 'proxy_name'
    O nome do proxy a ser alterado. O proxy_name é sysname, com um padrão de NULL.

  • [ @credential_name = ] 'credential_name'
    O nome da nova credencial para o proxy. O credential_name é sysname, com um padrão de NULL. Pode ser especificado o credential_name ou a credential_id.

  • [ @credential_id = ] credential_id
    O número de identificação da nova credencial para o proxy. A credential_id é int, com um padrão de NULL. Pode ser especificado o credential_name ou a credential_id.

  • [ @new_name= ] 'new_name'
    O novo nome do proxy. O new_name é sysname, com um padrão de NULL. Quando fornecido, o procedimento altera o nome do proxy para new_name. Quando esse argumento for NULL, o nome do proxy permanecerá inalterado.

  • [ @enabled = ] is_enabled
    Especifica se o proxy está habilitado. O sinalizador is_enabled é tinyint, com um padrão de NULL. Quando is_enabled for 0, o proxy não estará habilitado e não poderá ser usado por uma etapa de trabalho. Quando esse argumento for NULL, o status do proxy permanecerá inalterado.

  • [ @description= ] 'description'
    A nova descrição do proxy. A description é nvarchar(512), com um padrão de NULL. Quando esse argumento for NULL, a descrição do proxy permanecerá inalterada.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

É necessário especificar @proxy_name ou @proxy_id. Se os dois argumentos forem especificados, eles deverão se referir ao mesmo proxy, caso contrário o procedimento armazenado falhará.

É necessário especificar @credential_name ou @credential_id a fim de alterar a credencial para o proxy. Se os dois argumentos forem especificados, eles deverão se referir à mesma credencial, caso contrário o procedimento armazenado falhará.

Esse procedimento altera o proxy, mas não altera o acesso a ele. Para alterar o acesso a um proxy, use sp_grant_login_to_proxy e sp_revoke_login_from_proxy.

Permissões

Somente membros da função de segurança fixa sysadmin podem executar esse procedimento.

Exemplos

O exemplo a seguir define o valor habilitado para o proxy Catalog application proxy como 0.

USE msdb ;
GO

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

Consulte também

Referência

Procedimentos armazenados do SQL Server Agent (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)

Conceitos

Implementar a segurança do SQL Server Agent