sp_dropserver (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

Supprime un serveur de la liste des serveurs distants connus et liés sur l’instance locale de SQL Server.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_dropserver
    [ @server = ] N'server'
    [ , [ @droplogins = ] 'droplogins' ]
[ ; ]

Arguments

[ @server = ] N’server'

Serveur à supprimer. @server est sysname, sans valeur par défaut. @server doit exister.

[ @droplogins = ] 'droplogins'

Indique que les connexions de serveur distant et lié associées pour @server doivent également être supprimées si @droplogins est spécifié. @droplogins est char(10), avec la valeur par défaut NULL.

Valeurs des codes de retour

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

Notes

Une erreur est retournée si vous exécutez sp_dropserver sur un serveur avec des entrées de connexion de serveur distant et lié associées, ou si vous êtes configuré en tant qu’éditeur de réplication. Pour supprimer toutes les connexions de serveur distantes et liées pour un serveur lorsque vous supprimez le serveur, utilisez l’argument @droplogins.

sp_dropserver ne peut pas être exécuté à l’intérieur d’une transaction définie par l’utilisateur.

La modification sp_dropserver du nom du serveur local peut entraîner des effets inattendus ou des configurations non prises en charge.

autorisations

Nécessite l'autorisation ALTER ANY LINKED SERVER sur le serveur.

Exemples

L’exemple suivant supprime le serveur ACCOUNTS distant et toutes les connexions distantes associées de l’instance locale de SQL Server.

EXEC sp_dropserver 'ACCOUNTS', 'droplogins';