Partager via


sp_update_proxy (Transact-SQL)

S'applique à : SQL Server

Modifie les propriétés d'un proxy existant.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Numéro d'identification du proxy à modifier. @proxy_id est int, avec la valeur par défaut NULL.

[ @proxy_name = ] N’proxy_name'

Nom du proxy à modifier. @proxy_name est sysname, avec la valeur par défaut NULL.

[ @credential_name = ] N’credential_name'

Nom relatif aux nouvelles informations d'identification du proxy. @credential_name est sysname, avec la valeur par défaut NULL. Vous devez spécifier @credential_name ou @credential_id .

[ @credential_id = ] credential_id

Numéro d'identification des nouvelles informations d'identification du proxy. @credential_id est int, avec la valeur par défaut NULL. Vous devez spécifier @credential_name ou @credential_id .

[ @new_name = ] N’new_name'

Nouveau nom du proxy. @new_name est sysname, avec la valeur par défaut NULL. Quand elle est fournie, la procédure modifie le nom du proxy en @new_name. Lorsque cet argument est NULL, le nom du proxy reste inchangé.

[ @enabled = ] activé

Indique si le proxy est activé. @enabled est tinyint, avec une valeur par défaut de NULL. Lorsque @enabled est 0, le proxy n’est pas activé et ne peut pas être utilisé par une étape de travail. Lorsque cet argument est NULL, l’état du proxy reste inchangé.

[ @description = ] N’description'

Nouvelle description du proxy. @description est nvarchar(512), avec la valeur par défaut NULL. Lorsque cet argument est NULL, la description du proxy reste inchangée.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

Vous devez spécifier @proxy_name ou @proxy_id . Si ces deux arguments sont spécifiés, ils doivent tous les deux référencer le même proxy, sinon la procédure stockée échoue.

Vous devez spécifier @credential_name ou @credential_id pour modifier les informations d’identification du proxy. Si ces deux arguments sont spécifiés, ils doivent tous les deux référencer les mêmes informations d'identification, sinon la procédure stockée échoue.

Cette procédure modifie le proxy, mais ne modifie pas l’accès au proxy. Pour modifier l’accès à un proxy, utilisez sp_grant_login_to_proxy et sp_revoke_login_from_proxy.

autorisations

Seuls les membres du rôle de sécurité fixe sysadmin peuvent exécuter cette procédure.

Exemples

L'exemple suivant définit la valeur enabled pour le proxy Catalog application proxy sur 0.

USE msdb;
GO

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