Partilhar via


sp_update_proxy (Transact-SQL)

Aplica-se a:SQL Server

Altera as propriedades de um proxy existente.

Transact-SQL convenções de sintaxe

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' ]
[ ; ]

Arguments

[ @proxy_id = ] proxy_id

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

[ @proxy_name = ] N'proxy_name'

O nome do procurador para mudar. @proxy_name é sysname, com um padrão de NULL.

[ @credential_name = ] N'credential_name'

O nome da nova credencial para o procurador. @credential_name é sysname, com o 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 procurador. @new_name é sysname, com um padrão de NULL. Quando fornecido, o procedimento altera o nome do proxy para @new_name. Quando este argumento é NULL, o nome do procurador mantém-se inalterado.

[ @enabled = ] ativado

Especifica se o proxy está ativado. @enabled é tinyint, com um padrão de NULL. Quando @enabled é 0, o proxy não está ativado e não pode ser usado por um passo de trabalho. Quando este argumento é NULL, o estatuto do procurador mantém-se inalterado.

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

A nova descrição do proxy. @description é nvarchar(512), com um padrão de NULL. Quando este argumento é NULL, a descrição do proxy mantém-se inalterada.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

Deve ser especificado @proxy_name ou @proxy_id . Se ambos os argumentos forem especificados, ambos devem referir-se ao mesmo proxy ou o procedimento armazenado falha.

Deve ser especificado @credential_name ou @credential_id para alterar a credencial do proxy. Se ambos os argumentos forem especificados, devem referir-se à mesma credencial ou o procedimento armazenado falha.

Este 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.

Permissions

Apenas os membros do papel fixo de segurança de sysadmin podem executar este procedimento.

Examples

O exemplo seguinte define o valor habilitado para o proxy Catalog application proxy em 0.

USE msdb;
GO

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