sp_dropremotelogin (Transact-SQL)

Supprime une connexion distante mappée sur une connexion locale utilisée pour exécuter des procédures stockées distantes sur le serveur local exécutant SQL Server.

[!REMARQUE]

Cette fonctionnalité sera supprimée dans la prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et modifiez dès que possible les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt des serveurs liés et des procédures stockées de serveurs liés.

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

sp_dropremotelogin [ @remoteserver = ] 'remoteserver' 
     [ , [ @loginame = ] 'login' ] 
     [ , [ @remotename = ] 'remote_name' ]

Arguments

  • [ @remoteserver = ] 'remoteserver'
    Nom du serveur distant mappé sur la connexion distante à supprimer. remoteserver est de type sysname sans valeur par défaut. remoteserver doit déjà exister.

  • [ @loginame = ] 'login'
    Nom de connexion facultatif sur le serveur local qui est associé au serveur distant. login est de type sysname. Sa valeur par défaut est NULL. login doit déjà exister si cet argument est spécifié.

  • [ @remotename = ] 'remote_name'
    Nom facultatif de la connexion distante qui est mappée à login lors de la connexion d'accès à partir du serveur distant. remote_name est de type sysname. Sa valeur par défaut est NULL.

Valeurs des codes de retour

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

Notes

Si seul remoteserver est spécifié, toutes les connexions distantes sont supprimées du serveur local. Si vous spécifiez en outre login, toutes les connexions distantes de remoteserver mappées sur cette connexion locale sont supprimées sur le serveur local. Si vous spécifiez également remote_name, seule la connexion distante de cet utilisateur distant à partir de remoteserver est supprimée sur le serveur local.

Pour ajouter des utilisateurs au serveur local, utilisez sp_addlogin. Pour supprimer des utilisateurs du serveur local, utilisez sp_droplogin.

Les connexions distantes sont obligatoires uniquement lorsque vous utilisez des versions antérieures de SQL Server. SQL Server 7.0 et les versions ultérieures utilisent à la place des connexions de serveurs liés. Utilisez les procédures sp_addlinkedsrvlogin et sp_droplinkedsrvlogin pour ajouter et supprimer des connexions de serveurs liés.

Il n'est pas possible d'exécuter la procédure sp_dropremotelogin dans une transaction définie par l'utilisateur.

Autorisations

Nécessite l'appartenance en tant que membre au rôle serveur fixe sysadmin ou securityadmin

Exemples

A. Suppression de toutes les connexions distantes d'un serveur distant

Le code exemple suivant supprime l'entrée du serveur distant ACCOUNTS, supprimant ainsi tous les mappages entre les connexions sur le serveur local et les connexions distantes sur le serveur distant.

EXEC sp_dropremotelogin 'ACCOUNTS'

B. Suppression d'un mappage de connexion

Le code exemple suivant supprime l'entrée qui mappe des connexions distantes du serveur distant ACCOUNTS sur la connexion locale Albert.

EXEC sp_dropremotelogin 'ACCOUNTS', 'Albert'

C. Suppression d'un utilisateur distant

Le code exemple suivant supprime la connexion de l'utilisateur distant Chris sur le serveur distant ACCOUNTS qui a été mappée sur l'utilisateur local salesmgr.

EXEC sp_dropremotelogin 'ACCOUNTS', 'salesmgr', 'Chris'