sp_dropremotelogin (Transact-SQL)

S’applique à :SQL Server

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

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt des serveurs liés et des procédures stockées de serveur lié.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_dropremotelogin
    [ @remotename = ] N'@remotename'
    [ , [ @loginame = ] N'loginame' ]
    [ , [ @remotename = ] N'remotename' ]
[ ; ]

Arguments

[ @remotename = ] N'@remotename'

Nom du serveur distant mappé à la connexion distante à supprimer. @remotename est sysname, sans valeur par défaut. @remotename doit déjà exister.

[ @loginame = ] N’loginame'

Nom de connexion facultatif sur le serveur local associé au serveur distant. @loginame est sysname, avec la valeur par défaut NULL. @loginame doit déjà exister s’il est spécifié.

[ @remotename = ] N’remotename'

Nom facultatif de la connexion distante mappée à @loginame lors de la connexion à partir du serveur distant. @remotename est sysname, avec la valeur par défaut NULL.

Valeurs des codes de retour

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

Notes

Si seule @remotename est spécifiée, toutes les connexions distantes pour ce serveur distant sont supprimées du serveur local. Si @loginame est également spécifié, toutes les connexions distantes de @remotename mappées à cette connexion locale spécifique sont supprimées du serveur local. Si remote_name est également spécifié, seule la connexion à distance de cet utilisateur distant de @remotename est supprimée du serveur local.

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

Les connexions à distance sont requises uniquement lorsque vous utilisez des versions antérieures de SQL Server. SQL Server 7.0 et versions ultérieures utilisent plutôt des connexions de serveur lié. Utilisez sp_addlinkedsrvlogin et sp_droplinkedsrvlogin supprimez des connexions de serveur lié.

sp_dropremotelogin ne peut pas être exécuté dans une transaction définie par l’utilisateur.

Autorisations

Nécessite l’appartenance aux rôles serveur fixe sysadmin ou securityadmin .

Exemples

R. Supprimer toutes les connexions distantes pour 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. Supprimer 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. Supprimer 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';