Compartilhar via


sp_update_proxy (Transact-SQL)

Aplica-se a: SQL Server

Altera as propriedades de um proxy existente.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

O número de identificação de proxy do proxy a ser alterado. @proxy_id é int, com um padrão de NULL.

@proxy_name [ = ] N'proxy_name'

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

@credential_name [ = ] N'credential_name'

O nome da nova credencial para o proxy. @credential_name é sysname, com um padrão de NULL. Deve ser especificado @credential_name ou @credential_id .

@credential_id [ = ] credential_id

O número de identificação da nova credencial para o proxy. @credential_id é int, com um padrão de NULL. Deve ser especificado @credential_name ou @credential_id .

@new_name [ = ] N'new_name'

O novo nome do proxy. @new_name é sysname, com um padrão de NULL. Quando fornecido, o procedimento altera o nome do proxy para @new_name. Quando esse argumento é NULL, o nome do proxy permanece inalterado.

@enabled [ = ] habilitado

Especifica se o proxy está habilitado. @enabled é tinyint, com um padrão de NULL. Quando @enabled é 0, o proxy não está habilitado e não pode ser usado por uma etapa de trabalho. Quando esse argumento é NULL, o status do proxy permanece inalterado.

@description [ = ] N'descrição'

A nova descrição do proxy. @description é nvarchar(512), com um padrão de NULL. Quando esse argumento é NULL, a descrição do proxy permanece inalterada.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

Deve ser especificado @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á.

O @credential_name ou o @credential_id devem ser especificados para alterar a credencial do 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 ao proxy. 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