sp_update_proxy (Transact-SQL)

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

Syntaxe

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'

Arguments

[ @proxy_id= ] id

Numéro d'identification du proxy à modifier. L'argument proxy_id est de type int, avec NULL comme valeur par défaut.

[ @proxy_name= ] 'proxy_name'

Nom du proxy à modifier. L'argument proxy_name est de type sysname, avec NULL comme valeur par défaut.

[ @credential_name = ] 'credential_name'

Nom relatif aux nouvelles informations d'identification du proxy. L'argument credential_name est de type sysname, avec NULL comme valeur par défaut. credential_name ou credential_id peut être spécifié.

[ @credential_id = ] credential_id

Numéro d'identification des nouvelles informations d'identification du proxy. L'argument credential_id est de type int, avec NULL comme valeur par défaut. credential_name ou credential_id peut être spécifié.

[ @new_name= ] 'new_name'

Nouveau nom du proxy. L'argument new_name est de type sysname, avec NULL comme valeur par défaut. S'il est spécifié, la procédure change le nom du proxy en new_name. Si cet argument est NULL, le nom du proxy reste inchangé.

[ @enabled = ] is_enabled

Indique si le proxy est activé. L'argument is_enabled est de type tinyint, avec NULL comme valeur par défaut. Si is_enabled a la valeur 0, le proxy n'est pas activé et ne peut pas être utilisé par une étape du travail. Si cet argument est NULL, l'état du proxy reste inchangé.

[ @description = ] 'description'

Nouvelle description du proxy. L'argument description est de type nvarchar(512), avec NULL comme valeur par défaut. Si cet argument est NULL, la description du proxy reste inchangé.

Notes

Spécifiez @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 sans modifier son accès. 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.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Exemple

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

Voir aussi

Référence

sp_add_proxy (Transact-SQL)
sp_delete_proxy (Transact-SQL)
sp_grant_login_to_proxy (Transact-SQL)
sp_revoke_login_from_proxy (Transact-SQL)

Autres ressources

Implémentation de la sécurité de l'Agent SQL Server

Aide et Informations

Assistance sur SQL Server 2005